OpenAPI バリデーター
OpenAPI 3.0・3.1仕様(YAML/JSON)をブラウザで即座に検証。必須フィールド・パス構造・オペレーションレスポンスを確認し、仕様サマリーを表示。完全ブラウザ完結。
使い方
- OpenAPIスペック(YAMLまたはJSON)をエディターに貼り付けます。
- 検証をクリックするか Ctrl+Enter を押します。
- 有効な場合、APIタイトル・バージョン・パス数・オペレーション数がサマリーパネルに表示されます。
- 無効な場合、各エラーがJSONパスと説明付きでリスト表示されます。
OpenAPI 3.x 必須フィールド
openapi— バージョン文字列(例:“3.0.3”・“3.1.0”)info.title— API名info.version— APIバージョン(例:“1.0.0”)paths— パスアイテムマップ(各キーは/で始まる必要あり)
よくあるミス
- OpenAPI 3.xの代わりにSwagger 2.x形式(
swagger: “2.0”)を使用 —swaggerをopenapi: “3.0.3”に置き換え、definitionsをcomponents/schemasに更新します。 - オペレーション内に
responsesオブジェクトがない — すべてのオペレーションは少なくとも1つのレスポンスを宣言する必要があります。 /で始まらないパスキー — すべてのパスは絶対パスである必要があります(例:/users/{id})。- YAMLインデントエラー — まずYAML バリデーターで構文の問題を修正してください。
FAQ
対応するOpenAPIバージョンは?
OpenAPI 3.0.xおよび3.1.x仕様に対応しています。Swagger 2.x(OpenAPI 2.0)ドキュメントはバージョン警告と移行ヒントが表示されます。
YAMLとJSON両方を検証できますか?
はい。YAMLまたはJSONを貼り付けると、ツールが自動的にフォーマットを検出して解析します。
バリデーターは何をチェックしますか?
必須トップレベルフィールド(openapi・info・paths)、infoオブジェクトフィールド(title・version)、パス形式(/で始まる必要あり)、各オペレーションのresponsesオブジェクト有無を確認します。
APIスペックはサーバーに送信されますか?
いいえ。すべての検証はブラウザ内のJavaScriptで実行され、サーバーへの送信は一切ありません。
OpenAPI 3.xドキュメントの必須フィールドは?
openapi(バージョン文字列)、info.title、info.version、pathsが必須です。servers・components・tags・externalDocsはオプションです。