JSON Schema バリデータ

JSON データ

1
2
3
4
5
6
7
8
9
10

JSON Schema

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

検証結果

JSON データを検証

JSON データとスキーマを入力して構造と制約を検証します

型と構造を検証

必須プロパティをチェック

制約と format を確認

JSON Schema で JSON を検証する方法 – ステップガイド

API レスポンス、設定ファイル、payload サンプルをスキーマ契約に照らして検証します。デバッグ、ドキュメント化、コントラクトテストに有用です。

  1. ステップ 1 – JSON データを貼り付ける

    • JSON データ 」に JSON を貼り付けます。
    • JSON がファイル/URL/クリップボードにある場合は、インポートを使用します。
  2. ステップ 2 – JSON Schema を貼り付ける

    • JSON Schema 」にスキーマを貼り付けます。
    • 基本構造(type/properties/required/items)を中心に作ると安定します。 type, properties, required, items.
  3. ステップ 3 – 検証結果を読む

    • 右側のパネルには valid errors が表示されます。
    • エラーパスを使って、不一致のあるフィールドを正確に特定します。
  4. ステップ 4 – データまたはスキーマを修正する

    • データ側が誤っている場合は payload(欠落フィールド、型違い)を修正します。
    • 契約が変更された場合は、スキーマを更新して再度検証します。
  5. ステップ 5 – CI では厳密なバリデータを使う

    • 本番品質の検証(draft 対応、 $ref、合成)には、CI でフル機能の JSON Schema バリデータを実行してください。
    • スキーマをバージョン管理し、実 payload fixture に対してテストしましょう。

JSON Schema 機能に関する重要な注意

  • このバリデータは軽量に設計されており、基本 keyword( type, properties, required, items)にフォーカスしています。
  • 次のような機能に依存するスキーマ( $ref, anyOf, oneOf, または allOf )は、フル機能のバリデータが必要な場合があります。
例:スキーマに対して JSON を検証
// JSON data
{ "id": 1, "name": "Maeve Winters" }

// JSON Schema
{
  "type": "object",
  "properties": {
    "id": { "type": "integer" },
    "name": { "type": "string" },
    "email": { "type": "string" }
  },
  "required": ["id", "name", "email"]
}

// Result
{
  "valid": false,
  "errors": ["root: Missing required property 'email'"]
}

関連する JSON Schema ツール

スキーマ生成、モック作成、検証前の JSON 整形を組み合わせて効率化できます。

よくある質問

JSON Schema 検証とは?

JSON Schema 検証は、JSON ドキュメントが指定されたスキーマに従っているかを確認する処理です。型、必須プロパティ、制約、構造ルールを検証します。

JSON をスキーマで検証するには?

入力エディターに JSON データを、設定パネルにスキーマを入力します。入力に応じて自動的に検証が行われます。

どんな検証エラーが起こり得ますか?

よくあるエラーには、型不一致、必須プロパティの欠落、許可されない追加プロパティ、文字列長の違反、数値範囲の違反などがあります。

カスタム JSON Schema を使えますか?

はい。標準的な JSON Schema JSON を貼り付けられます。ただし、このバリデータは type/properties/required/items などの基本 keyword にフォーカスしており、$ref の解決や高度な合成 keyword を完全には評価しません。

JSON Schema バリデータ | JSONSwiss