wake-up-neo.net

Konvertieren Sie Swagger JSON in RAML/YAML

Wie konvertiere ich Swagger JSON in RAML/YAML und validiere es? Ich suche keinen programmatischen Weg, nur eine einmalige Konvertierung.

13
helios

Hier sind die Schritte:

  1. Exportieren Sie Swagger JSON in eine Datei auf Ihrem Laufwerk. Diese JSON sollte auf Ihrem Server unter dem folgenden URI veröffentlicht werden:/swagger/docs/v1 
  2. Gehe zu http://editor.swagger.io/#/
  3. Wählen Sie in der oberen linken Ecke Datei-> Datei importieren aus. Zeigen Sie auf die lokale Swagger-JSON-Datei, die Sie in Schritt 1 exportiert haben, um sie im Swagger-Editor zu öffnen 
  4. Wählen Sie aus dem Menü die Option Client generieren -> Swagger YAML 
  5. Es wird die YAML generiert, die Sie unter http://www.yamllint.com/ site überprüfen können
13
helios

Umwandlung

Wenn Sie eine Konvertierung von einer beliebigen Version von Swagger nach RAML 0.8 suchen, kann APITransformer.com dies für Sie tun. Wir sind fast fertig mit dem Export von RAML 1.0. Wird es in einer Woche veröffentlichen.

Validierung

Die konvertierte Beschreibung stammt aus der gleichen Code-Gen-Engine, mit der APIMatic eine API-Beschreibung überprüft, bevor SDKs/Client-Bibliotheken generiert werden. Daher wird die konvertierte RAML standardmäßig überprüft. 

API-Beschreibungen in einer Vielzahl von Formaten können auch über APIMatic CLI oder APIMatic API validiert werden. /

4
Adeel Ali

Es ist eigentlich ziemlich einfach

Die Webversion von swagger editor gibt Ihnen die Flexibilität, Ihre vorhandene Swagger-Datei (JSON/YAML) zu importieren und die aktuell angezeigte Konfigurationsdatei herunterzuladen. Also, kombiniere einfach diese beiden.

Hinweis: Das Konvertieren von JSON in YAML ist vorhanden, nicht jedoch von JSON in RAML

  1. Importieren Sie zunächst Ihre Swagger-JSON unter http://editor.swagger.io/#/(Datei> Datei importieren).
  2. Sobald Sie Ihre Konfigurationen sehen, laden Sie einfach die entsprechende YAML-Version (Datei> Download YAML) herunter.

Die YAML-Version des gerade hochgeladenen JSON wird heruntergeladen.

2
Nikhil Nanjappa

Um API-Spezifikationen zwischen verschiedenen Formaten (z. B. Swagger/OpenAPI, RAML, Postman usw.) zu konvertieren, können Sie die folgenden kostenlosen und Open-Source-Tools verwenden:

2
William Cheng

Ich wünsche mir zwar, dass es ein Befehlszeilentool gibt, diese Firma hat jedoch einen Konverter erstellt:

https://apitransformer.com/

0
coding