OpenAPI バリデーター

OpenAPI 3.0・3.1仕様(YAML/JSON)をブラウザで即座に検証。必須フィールド・パス構造・オペレーションレスポンスを確認し、仕様サマリーを表示。完全ブラウザ完結。

100% クライアントサイド データはブラウザ外に出ません 無料 · 登録不要

使い方

  1. OpenAPIスペック(YAMLまたはJSON)をエディターに貼り付けます。
  2. 検証をクリックするか Ctrl+Enter を押します。
  3. 有効な場合、APIタイトル・バージョン・パス数・オペレーション数がサマリーパネルに表示されます。
  4. 無効な場合、各エラーが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”)を使用 — swaggeropenapi: “3.0.3”に置き換え、definitionscomponents/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はオプションです。