web-dev-qa-db-fra.com

Conversion de Swagger JSON en RAML/YAML

Comment convertir un fichier JSON Swagger en RAML/YAML et le valider? Je ne cherche pas une méthode de programmation, mais une conversion unique.

jsonapiyamlswaggerraml
13
helios

Voici les étapes:

  1. Exportez Swagger JSON dans un fichier sur votre lecteur. Ce JSON doit être publié sur votre serveur à l'URI suivant:/swagger/docs/v1 
  2. Allez à http://editor.swagger.io/#/
  3. En haut à gauche, sélectionnez Fichier-> Importer un fichier ... Pointez sur le fichier JSON Swagger local que vous avez exporté à l'étape 1 pour l'ouvrir dans l'éditeur Swagger 
  4. Sélectionnez Generate Client -> Swagger YAML dans le menu. 
  5. Il générera le YAML que vous pourrez valider sur http://www.yamllint.com/ site
13
helios

Conversion

Si vous souhaitez convertir une version de Swagger en RAML 0.8, APITransformer.com peut le faire pour vous. Nous en avons presque terminé avec l'exportation RAML 1.0. Le publiera dans une semaine.

Validation

La description convertie provient du même moteur de génération de code qu'APIMatic utilise pour valider une description d'API avant de générer des bibliothèques SDK/Client. Par conséquent, la RAML convertie sera validée par défaut. 

Les descriptions d'API dans divers formats peuvent également être validées via l'interface de ligne de commande APIMatic ou l'interface de programme d'application APIMatic

4
Adeel Ali

C'est en fait assez simple

La version Web de swagger editor offre la possibilité d'importer votre fichier swagger existant (JSON/YAML) et de télécharger le fichier de configuration actuellement affiché. Alors combinez simplement ces deux.

Remarque: La conversion de JSON en YAML existe, mais pas de JSON en RAML.

  1. Commencez par importer votre JSON swagger à l’emplacement http://editor.swagger.io/#/(Fichier> Fichier d’importation).
  2. Une fois que vous voyez vos configurations, il vous suffit de télécharger la version YAML correspondante (Fichier> Télécharger YAML).

La version YAML du JSON que vous venez de télécharger sera téléchargée.

2
Nikhil Nanjappa

Pour convertir les spécifications de l'API entre différents formats (par exemple, Swagger/OpenAPI, RAML, Postman, etc.), vous pouvez utiliser les outils libres et open source suivants:

2
William Cheng

Bien que j'aimerais avoir un outil en ligne de commande, cette société a créé un convertisseur, il semble

https://apitransformer.com/

0
coding