web-dev-qa-db-ja.com

Swagger JSONをRAML / YAMLに変換

Swagger JSONをRAML/YAMLに変換して検証するにはどうすればよいですか？プログラマティックな方法を探しているのではなく、1回限りの変換を探しています。

jsonapiyamlswaggerraml
16
helios

手順は次のとおりです。

  1. Swagger JSONをドライブ上のファイルにエクスポートします。このJSONは、次のURIでサーバーに公開する必要があります：/ swagger/docs/v1
  2. http://editor.swagger.io/#/ に移動します
  3. 左上の[ファイル]-> [ファイルのインポート...]を選択し、ステップ＃1でエクスポートしたローカルSwagger JSONファイルをポイントしてSwaggerエディターで開きます。
  4. メニューから[クライアントの生成]-> [YAMLのSwaggerオプション]を選択します
  5. http://www.yamllint.com/ サイトで検証できるYAMLを生成します
15
helios

変換

任意のバージョンのSwaggerからRAML 0.8に変換する場合は、APITransformer.comを使用できます。 RAML 1.0のエクスポートはほぼ完了です。 1週間以内にリリースします。

検証

変換された説明は、SDK /クライアントライブラリを生成する前にAPIMaticがAPIの説明を検証するために使用するコード生成エンジンと同じです。したがって、変換されたRAMLはデフォルトで検証されます。

さまざまな形式のAPI記述は、 APIMaticのCLI または APIMaticのAPI で検証することもできます

4
Adeel Ali

API仕様をさまざまな形式（Swagger/OpenAPI、RAML、Postmanなど）に変換するには、次の無料のオープンソースツールを使用できます。

3
William Cheng

実際には非常に簡単です

swagger editor のWebバージョンは、既存のswaggerファイル（JSON/YAML）をインポートし、現在表示されている構成ファイルをダウンロードする柔軟性を提供します。したがって、これら2つを組み合わせてください。

注：JSONからYAMLへの変換は存在しますが、JSONからRAMLへの変換はありません

  1. 最初に http://editor.swagger.io/#/（File> Import File）でswagger JSONをインポートします
  2. 設定を確認したら、対応するYAMLバージョン（ファイル> YAMLのダウンロード）をダウンロードするだけです。

アップロードしたJSONのYAMLバージョンがダウンロードされます。

2
Nikhil Nanjappa

コマンドラインツールがあればいいのに、この会社はコンバーターを作ったようです：

https://apitransformer.com/

0
coding