JSONスキーマバリデーター

JSONスキーマに対してJSONデータを検証。正確なパス付きの詳細なエラーメッセージ。

1
2
3
JSON Data
JSON Schema

JSONスキーマのベストプラクティス

より良いスキーマを書いて、より多くの検証エラーを検出。

1

必須フィールドから始める

まずrequired配列を定義し、各プロパティに型制約を追加。

2

説明的なエラーメッセージを使用

各プロパティにdescriptionを追加。検証エラー時の理解に役立ちます。

3

スキーマコンポジションを活用

allOf、anyOf、oneOfでシンプルなスキーマから複雑なスキーマを構成。$refで共有定義。

4

CI/CDパイプラインで検証

ビルドパイプラインでJSONスキーマ検証を実施して無効な設定を早期検出。

スキーマ検証機能

包括的なJSONスキーマ検証ツール。

スキーマドラフトサポート

JSON Schema Draft 4、6、7、2019-09、2020-12をサポート。

詳細なエラーレポート

検証の失敗箇所を正確に示すJSONパス付きの精密なエラーメッセージ。

サイドバイサイド表示

JSONデータとスキーマをサイドバイサイドで簡単にクロスリファレンス。

JSONスキーマとは?

JSONスキーマはJSONデータの構造と内容を検証するための語彙です。JSONドキュメントの期待される形・型・制約を記述します——データベーススキーマがテーブル構造を定義するのと同様です。

基本的な例

"name"(文字列)と "age"(数値)を要求するスキーマ:

JSONスキーマ
{
  "type": "object",
  "required": ["name", "age"],
  "properties": {
    "name": { "type": "string" },
    "age": { "type": "number", "minimum": 0 }
  }
}

有効なデータ

{ "name": "Alice", "age": 30 }

無効なデータ

{ "name": 123, "age": -5 }

主要キーワード

type

期待する型を定義:string、number、object、array、boolean、null

required

オブジェクトに必須のプロパティ名を列挙

properties

オブジェクトの各プロパティのスキーマを定義

items

配列要素のスキーマ——各要素を検証

enum

値を固定された許可値リストに制限

pattern

正規表現パターンで文字列を検証

JSONスキーマバリデーター FAQ

JSONスキーマとは?

JSONスキーマはJSONドキュメントを注釈付けして検証するための語彙です。構造、型、制約を定義します。

どのスキーマドラフトがサポートされていますか?

Draft 4、6、7、2019-09、2020-12。バージョンは$schemaキーから自動検出されます。

ネストされたオブジェクトを検証できますか?

はい、$ref参照やallOf/anyOf/oneOfを含むネストされたスキーマを完全サポート。

必須フィールドはどう指定しますか?

propertiesと同じレベルにrequired配列を追加し、必須フィールド名を記述します。

anyOf、oneOf、allOfの違いは?

allOf:すべてに一致。anyOf:少なくとも1つに一致。oneOf:正確に1つに一致。

バリデーターはスキーマ自体を検証しますか?

はい、スキーマは有効なJSONであり、JSONスキーマ構文に従う必要があります。

共有定義に$refを使えますか?

はい、内部$ref参照は完全にサポート。再利用可能なサブスキーマを定義できます。

関連ツール

ほかの JSON ツールも活用してワークフローを効率化しましょう。