JSON Swiss

JSON Swiss

JSON Schema 生成

JSON データ 入力

1

JSON Schema 出力

設定
入力変更時に自動生成有効

JSON Schema を生成

左側に JSON データを入力すると、対応する JSON Schema を自動生成します

• ネストしたオブジェクトと配列に対応

• 型を自動検出

• 検証ルールを生成

JSON から JSON Schema を生成する方法 – ステップガイド

このオンライン JSON Schema ジェネレーターを使うと、代表的な JSON サンプルからスキーマ定義を作成し、検証・ドキュメント化・API コントラクトに活用できます。

  1. ステップ 1 – JSON サンプルを用意する

    • 左側のエディターに、代表的な JSON オブジェクトまたは配列を貼り付けます。
    • 実データに近いサンプルを使うと、スキーマが構造を正確に反映します。
    • 取り得る値やネスト構造の例をできるだけ含めます。

  2. ステップ 2 – 生成されたスキーマを確認する

    • 右側に、推定された型、必須フィールド、構造定義を含むスキーマが表示されます。
    • 配列の item、ネストしたオブジェクト、プロパティ型が想定どおりか確認します。
    • 任意／必須の判定が正しいか検証します。

  3. ステップ 3 – スキーマを調整する（任意）

    • 生成したスキーマをコピーし、独自の検証ルール、説明、制約を追加します。
    • enum 値、 minLength/maxLength, や pattern 正規表現などを必要に応じて追加します。
    • union 型には oneOf または anyOf を定義します。

  4. ステップ 4 – スキーマを活用する

    • スキーマをダウンロード／コピーして、JSON バリデータ、API ドキュメントツール、コードジェネレーターで使用します。
    • Ajv（JavaScript）、jsonschema（Python）などの検証ライブラリと統合できます。
    • OpenAPI/Swagger で参照したり、型安全なコード生成に利用します。

スキーマ生成のクイックヒント

  • 本番で使う前に、生成スキーマを JSON バリデータや実行環境のライブラリで必ず検証してください。
  • 現実的なサンプルデータを使うと、型推論と必須判定の精度が上がります。
  • payload（例：API request/response）ごとに 1 つの正本スキーマを維持し、環境差分によるドリフトを防ぎましょう。

スキーマ keyword 対応に関する注意

次のような高度な keyword（ $ref, anyOf, oneOf, や allOf）を追加する場合は、フル機能の JSON Schema バリデータ（例：Ajv）で検証し、モック生成前にスキーマの dereference も検討してください。

例：JSON → JSON Schema
// JSON input
{
  "id": 1,
  "name": "Maeve Winters",
  "email": "[email protected]",
  "active": true,
  "tags": ["developer", "backend"]
}

// Generated JSON Schema (simplified)
{
  "type": "object",
  "properties": {
    "id": { "type": "number" },
    "name": { "type": "string" },
    "email": { "type": "string" },
    "active": { "type": "boolean" },
    "tags": {
      "type": "array",
      "items": { "type": "string" }
    }
  },
  "required": ["id", "name", "email", "active", "tags"]
}

関連する JSON Schema／検証ツール

スキーマ生成と併用して、検証・ドキュメント化・JSON の扱いを効率化できます。

JSON Schema 検証

一般的な schema keyword に対して JSON payload を検証し、差分を早期に検出します。

JSON Schema モックデータ生成

スキーマから現実的なサンプル JSON を生成し、テストやドキュメント、fixture に利用します。

JSON Formatter

スキーマ生成前に JSON サンプルを整形・クリーンアップして精度を高めます。

Schema Library

オブジェクト、配列、enum、検証ルールのパターンや例を参照できます。

JSON → TypeScript 型

スキーマ生成に使った JSON から TypeScript の interface を生成します。

JSON → Java クラス

JSON から Java POJO を生成し、Jackson などでランタイム検証に活用します。

よくある質問

JSON Schema とは何ですか？

JSON Schema は、JSON ドキュメントに注釈を付けたり検証したりするための仕様（語彙）です。アプリケーションが必要とする JSON データの契約（コントラクト）を表現できます。

JSON データからスキーマを生成するには？

左側の入力エディターに JSON を貼り付けるだけで、データ構造に基づいてスキーマが自動生成されます（型、必須フィールド、パターンなど）。

生成されるスキーマには何が含まれますか？

型情報、必須プロパティ、プロパティ定義、配列要素の定義、オブジェクト構造、JSON パターンに基づく検証制約が含まれます。

生成後にスキーマをカスタマイズできますか？

はい。生成したスキーマをコピーして、追加の制約、説明、検証ルールなどを必要に応じて追記できます。

JSON Schema 生成 | JSONSwiss