7
Come convertire Swagger JSON in RAML/YAML e convalidarlo? Non sto cercando un modo programmatico, solo una conversione una tantum.Converti Swagger JSON in RAML/YAML
A
risposta
8
Ecco i passaggi:
- Export Swagger JSON in un file sul disco rigido. Questo JSON dovrebbe essere pubblicato sul server al seguente URI:/spavalderia/docs/v1
- Vai http://editor.swagger.io/#/
- Nell'angolo in alto a sinistra, selezionare File-> Importa file ... Puntare al file JSON Swagger locale esportati nel passaggio # 1 per aprire nel Swagger Editor
- selezionare genera client -> opzione Swagger YAML dal menu
- Essa genererà il YAML che è possibile convalidare a http://www.yamllint.com/ sito
1
Mentre auguro c'era uno strumento da riga di comando, questa azienda ha realizzato un convertitore a quanto pare:
+0
C'è anche uno strumento da riga di comando per le conversioni. Si trova su https://github.com/apimatic/apimatic-cli –
+0
Il link https://apimatic.io/transformer funziona davvero e fare lo stesso con il loro apimatic-cli sembra essere complicato. Avresti una guida pronta per l'uso? – gronaz
3
conversione
Se stai cercando di convertire da qualsiasi versione Swagger a Raml 0,8 poi APITransformer.com può farlo per voi. Abbiamo quasi finito con l'esportazione RAML 1.0. Lo rilascerà tra una settimana.
convalida
La descrizione convertita esce dal motore stesso codice-gen che APIMatic per convalidare una descrizione API prima di generare librerie SDK/cliente. Pertanto, la RAML convertita verrà convalidata per impostazione predefinita.
descrizioni API in una varietà di formati possono anche essere convalidati tramite APIMatic's CLI o APIMatic's API
1
Per convertire specifiche API tra vari formati (ad esempio Swagger/OpenAPI, Raml, postino, ecc), è possibile utilizzare il seguente gratuita e strumenti open source:
0
In realtà è piuttosto semplice
La versione Web di swagger editor offre la flessibilità di importare il file swagger esistente (JSON/YAML) e di scaricare il file di configurazione che viene attualmente mostrato. Quindi combina questi due.
Nota: La conversione di JSON per YAML esiste, ma non JSON a Raml
- prima importazione tua JSON spavalderia a http://editor.swagger.io/#/(File> Import File)
- Una volta che vedi le configurazioni , scaricare la corrispondente versione YAML (File> Scarica YAML).
La versione YAML del JSON appena caricato verrà scaricata.
Non penso che sia la domanda, questo genera Swagger YAML, non RAML YAML. – coding
Questo non risponde alla domanda ma la soluzione reale può essere trovata usando quasi allo stesso modo - Trova la mia risposta qui sotto. –