Question 1

JSON Schema ジェネレーターは何をするの？

Accepted Answer

サンプルの JSON ドキュメントを解析し、それを記述するスキーマを推論します。各値の型、ネストしたオブジェクトのプロパティ、配列の要素スキーマです。結果はそのまま使える draft-07 または 2020-12 の JSON Schema で、コピーもダウンロードもできます。

Question 2

スキーマの推論はどう動く？

Accepted Answer

ジェネレーターはサンプル値を再帰的にたどります。文字列は string プロパティ（date や email など判定された形式を付与可）、整数は integer、小数は number、真偽値は boolean、null は null、配列は選択した戦略で要素スキーマを持つ array、オブジェクトは properties マップを持つ object になります。

Question 3

必須オプションの効果は？

Accepted Answer

有効にすると、オブジェクト内で見つかったすべてのプロパティを必須として扱います。ジェネレーターは JSON Schema の仕様に沿って、オブジェクトごとに正しい required 配列へ整理します。実データで欠けうるフィールドがあるならオフにしてください。

Question 4

配列戦略はどれを選ぶべき？

Accepted Answer

「全要素を統合」はすべての要素をカバーする要素スキーマを作ります（integer と number は number に統合など）。「先頭要素のみ」は 0 番目の要素のスキーマを採用。「要素の型を統一」は全要素が同じスキーマであることを要求し、異なればエラー。「タプル（位置ごと）」は位置ごとにスキーマを保持し、固定長配列に最適です。

Question 5

$schema バージョンヘッダーを追加できる？

Accepted Answer

はい。$schema バージョンの select で、公式の draft-07 URI、2020-12 URI、または追加なしを選べます。ヘッダーは下流のバリデーターにスキーマの従う仕様を伝えます。

Question 6

文字列フォーマット判定とは？

Accepted Answer

有効にすると、メールアドレスや日付、ホスト名らしき文字列値に format 注記（例：format: email）が付きます。スキーマは精密になりますが、短いテキストに過剰に付くこともあり、純粋な string 型にしたい場合はオフにできます。

Question 7

生成されたスキーマは完璧？

Accepted Answer

単一サンプルからの推論は完璧になりません。スキーマは与えたサンプルを正確に反映します。欠けている任意フィールドは現れず、エッジケースは手動調整が必要です。出力を強力な出発点と捉え、実際の契約に合わせて範囲・pattern・enum を調整してください。

Question 8

データはどこかに送信される？

Accepted Answer

いいえ。スキーマの推論は完全にブラウザ内で行われ、サーバーには何も送信されません。サンプルはローカルファイルから読み込め、直近の入力はこのブラウザのローカルストレージにのみ保存されます。

JSON Schema ジェネレーター

JSON Schema ジェネレーターの使い方