JSONスキーマとは
JSONスキーマ(JSON Schema)は、JSONデータの構造を記述・検証するための仕様です。「このオブジェクトはどのようなプロパティを持つか」「各フィールドの型は何か」「どのフィールドが必須か」「文字列のフォーマットはどうあるべきか」といった制約を機械可読な形式で定義できます。APIの設計・ドキュメント生成・コード自動生成・入力バリデーションなど、様々な場面で活用されています。
広く使われているバージョンは Draft-07(ほぼすべての言語のバリデーションライブラリが対応)と、現行の安定仕様である Draft 2020-12 です。このツールはボタン一つで両バージョンを切り替えられます。
このJSONスキーマジェネレーターの使い方
スキーマ生成 — 左の入力欄にJSONを貼り付けて「スキーマ生成」をクリックします。ツールは各値を再帰的に検査し、true/false を boolean、整数を integer、小数を number、null を null、配列・オブジェクトをそれぞれの型にマッピングします。文字列は日時(date-time)・メールアドレス(email)・URL(uri)・UUID のパターンを自動検出し、format キーワードを付加します。
スキーマバージョン切替 — 「Draft-07」または「2020-12」ボタンで $schema URIを切り替えます。入力済みの場合は即座に再生成されます。
プロパティ編集 — スキーマ生成後、下部に「スキーマプロパティを編集」テーブルが表示されます。各プロパティに description(説明文)を追加し、「必須」チェックボックスで required 配列を制御できます。「編集を適用して再生成」をクリックすると反映されます。
JSONを検証 — 「JSONを検証」をクリックすると、入力JSONを生成済みスキーマと照合します。型の不一致・必須フィールドの欠落・ネスト構造のエラーをJSONパスとともに報告します。
サンプルプリセット — 「サンプル」ドロップダウンから3種類の例を読み込めます。ユーザーオブジェクト(UUID・メール・日時・ネスト住所・ロール配列)、商品カタログ(価格・評価・画像配列)、APIレスポンス(ページネーション・ネストデータ・メタ情報)。
スキーマをコピー — 「スキーマをコピー」ボタンで生成済みスキーマをクリップボードに一発コピーできます。
関連ツール
JSONを整形 → JSONフォーマッター
JSONをCSVに変換 → JSON to CSV
YAML ↔ JSON を相互変換 → YAML↔JSONコンバーター
エンジニア・フリーランスの確定申告を自動化
開発に集中したいのに、経理業務に時間を取られていませんか?クラウド会計ソフト「freee」なら、銀行口座・クレジットカードと自動連携。確定申告もワンクリック。
