Swift Struct → JSON Schema 生成

Swift コード 入力

エディターを読み込み中…

JSON Schema 出力

設定

JSON Schema の root として扱う struct/class を選択します。

解析はブラウザー内で完結します。ソースコードが外部に送信されることはありません。

Swift のモデルを貼り付けて JSON Schema を即生成。

Codable struct、optional 型、配列、辞書、ネストしたモデルに対応します。

Swift の struct を JSON Schema に変換する方法 – ステップガイド

このオンライン Swift struct → JSON Schema 変換ツールは、実際のモデル(DTO、struct、class)から JSON Schema を生成し、payload の検証、コントラクト共有、モック JSON 生成に役立ちます。

  1. ステップ 1 – Swift のソースを貼り付ける

    • ドキュメント化したいモデルを左側のエディターに貼り付けます。
    • 参照される型も同じスニペットに含めると、definitions を生成できます。
    • サンプル ボタンで例を読み込み、入力フォーマットを確認できます。
  2. ステップ 2 – ルート型 を選択する(必要な場合)

    • 複数の定義が検出された場合は、API payload に対応する root を選択します。
    • 出力スキーマは選択した root を中心に構築され、参照される型の定義を含むことがあります。
  3. ステップ 3 – JSON Schema 出力を確認する

    • 型、必須/任意フィールド、ネストした object/array 構造を確認します。
    • モデルが他のモデルを参照している場合は、 definitions $ref を確認してください。
    • スキーマをコピーまたはダウンロードして、検証/ドキュメント化/schema‑first 開発に利用します。
  4. ステップ 4 – 検証またはモック JSON を生成する

    • モックデータ生成 」をクリックすると、スキーマを読み込んだ状態でモック生成ツールを開けます。
    • 実 payload をスキーマで検証し、破壊的変更を早期に検出します。
    • 高度な schema 合成(例: anyOf/oneOf/allOf)を使う場合は、Ajv などのフルバリデータで結果を確認してください。

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

生成されたスキーマには $ref が含まれることがあり、編集して anyOf, oneOf, または allOfを追加できます。 複雑なスキーマの場合は、フル機能の JSON Schema バリデータを使い、必要に応じてモック生成前に dereference してください。

関連する JSON Schema/コード生成ツール

スキーマの検証、モック payload の生成、JSON 例の整形、コードとコントラクトの同期に役立つツールです。

よくある質問

対応している Swift の型は?

stored property を持つ struct と class を解析します。optional 型(String?)、配列、辞書、既定値、Codable の注釈(@CodingKey は無視されますが安全)、ネスト型に対応します。Swift/SwiftUI プロジェクトからモデルをそのまま貼り付けられます。

Swift の型は JSON Schema にどうマッピングされますか?

String/Int/Double/Bool は schema のプリミティブに対応します。[Address] のような配列は schema array、辞書は object、optional 型は任意フィールドになります。未知のカスタム型は、入力内に同名の struct/class がない限り string にフォールバックします。

複数の struct を含められますか?

はい。関連する複数の struct を貼り付け、設定のドロップダウンから root 型を選択できます。すべてローカルでブラウザー内実行のため、ソースコードはアップロードされません。

モック JSON データはどう作りますか?

スキーマ生成後に「モックデータ生成」をクリックすると、スキーマを読み込んだ状態で Mock Generator を開けます。ロケール、配列数、任意フィールドを設定して、サンプル payload をすぐに作成できます。

Swift Struct → JSON Schema 生成 | JSONSwiss