OpenAPI 2 から 3 へのコンバーター

OpenAPI 2 から 3 へのコンバーター

Swagger 2.0 のスペックを貼り付け、JSON または YAML 形式で有効な OpenAPI 3.0.3 バージョンを返します。コンバーターは公式な構造マッピングルールを適用— definitions under components/schemas、 host, basePathと、 schemes の中へ serversを収縮し、 consumes と produces を各操作に分離し、フォームパラメータとセキュリティ定義を再構成—現代の OpenAPI ツールで動作するようになります。 content Swagger 2.0 スペックを入力ボックスに貼り付けます。JSON および YAML はどちらも受け入れ可能で、形式は自動検出されます。

使用方法

1. 出力フォーマットを選択：入力フォーマットを維持するか、JSON または YAML に強制します。
2. 必須フィールドを補完
3. 離脱 を自動で埋め込み、v3 の必須フィールド（ など）および v2 のソースが省略した応答説明を補完します。 info.title, info.version変換の要約および出力の上部に表示される警告を確認し、結果の OpenAPI 3.0.3 スペックをコピーまたはダウンロードします。
4. JSON および YAML 入力、JSON または YAML 出力

機能

• — 好みのフォーマットを選択するか、入力と同じフォーマットを維持します。 構造マッピング
• は — definitions → components/schemas, securityDefinitions → components/securitySchemes, parameters/responses の下に引き上げられ、すべての componentsポインタは再構成され、一致するようになります。 $ref ホスト、basePath、スキームからサーバー
• — これらは v3 の 配列に統合され、複数のスキームがある場合、HTTPS が優先されます。 servers コンテンツネゴテイション
• は各操作に分離された — consumes と produces マップに変換されます。 requestBody.content と responses[*].content ボディおよびフォームパラメータ
• は v3 の — in: body フィールドに変換され、すべての requestBodyと、 in: formData はリクエストボディスキーマにグループ化されます。 multipart/form-data または application/x-www-form-urlencoded セキュリティフローのアップグレード
• — OAuth2 値は v3 の flow オブジェクト（ flows パッチモードimplicit, password, clientCredentials, authorizationCode).
• — 有効にすると、出力が v3 バリデーターを通過するように必須フィールドを補完し、v2 ソースの小さな欠陥による失敗を回避します。 変換要約および警告
• — 変換されたパス、スキーマ、セキュリティスキームの数、1 対 1 にマッピングできないものに対する警告を表示します。 — あなたのスペックはページを離れないでください。
• ブラウザ内で完全に動作 Swagger 2.0 と OpenAPI 3.0 の間で構造的に何が変わったか？