JSON → Zod スキーマ

JSONデータからZodバリデーションスキーマを即座に生成。ネストオブジェクト・配列・nullable・省略可能プロパティに対応。ブラウザ内で処理。

  • ブラウザ内で処理
  • ツールの入力を ZeroTool のサーバーにアップロードしません
  • 無料 · 登録不要
スキーマ定数と推論した型の名前を設定します。空欄では Root を使います。変更後は「Zod スキーマを生成」で適用します。
生成する z.object スキーマに .strict() を付け、Zod が余分なキーを拒否するようにします。「Zod スキーマを生成」で適用します。
現在の JSON、ルート名、ストリクトモードで生成します。Ctrl/⌘+Enter でも生成できます。
入力をネストされたオブジェクト、配列、null を含むサンプルに置き換え、現在のルート名とストリクトモードで生成します。
JSON、出力、ステータスを消去し、ルート名とストリクトモードは保持します。ツール内の Ctrl/⌘+L ではルート名も消去します。
有効な JSON を入力します。入力を止めてから 300 ミリ秒後に生成し、無効な JSON では出力を消去します。ルートにはオブジェクト、配列、プリミティブを使えます。
Zod スキーマ出力
Zod のインポート、スキーマ、推論した型を含む表示中の TypeScript コードを全文コピーします。出力が空の場合はコピーしません。

JSON を入力するかサンプルを読み込むと、Zod スキーマを生成します。

例・詳しい説明・よくある質問 実際の出力つきの例、ほかのツールとの違い、よくある質問。

出力されるコード

出力はそのまま .ts ファイルに貼れるコードです。1 行目が import { z } from "zod";、続いて const 名前Schema = …;、最後に export type 名前 = z.infer<typeof 名前Schema>; が並びます。スキーマ定数には export が付かないので、ほかのモジュールから使う場合は自分で付けます。名前は「ルートスキーマ名」から作られ、空欄なら Root です。ルートスキーマ名は先頭を大文字にし、ECMAScript の識別子のルールで整えます。日本語を含む各言語の文字、数字、$、_ は残るので、天気 は 天気Schema になります。それ以外の文字は取り除かれて次の文字が大文字になり(user profile は UserProfileSchema)、識別子の先頭に使えない名前には T が付きます(2fa は T2faSchema)。何も残らない場合は Root です。

例:気象庁の天気概況 JSON

気象庁サイトの天気予報ページが読み込んでいる天気概況の JSON(https://www.jma.go.jp/bosai/forecast/data/overview_forecast/130000.json、東京都)を 2026 年 10 月 8 日に取得し、そのまま貼りました。ルート名は Overview です。

{"publishingOffice":"気象庁","reportDatetime":"2026-10-08T16:35:00+09:00","targetArea":"東京都","headlineText":"","text":" 日本海の高気圧が本州付近に張り出しています。\n\n 東京地方は、晴れています。\n\n 8日は、高気圧に覆われる見込みです。このため、晴れるでしょう。\n\n 9日は、引き続き高気圧に覆われる見込みです。このため、晴れるでしょう。"}

出力:

import { z } from "zod";

const OverviewSchema = z.object({
  publishingOffice: z.string(),
  reportDatetime: z.string(),
  targetArea: z.string(),
  headlineText: z.string(),
  text: z.string(),
});

export type Overview = z.infer<typeof OverviewSchema>;

すべて z.string() になります。空文字列の headlineText も、全角スペースや改行を含む text も、ツールから見れば同じ文字列です。日時の reportDatetime を厳密にチェックしたいときは、Zod 4 なら z.iso.datetime({ offset: true })、Zod 3 なら z.string().datetime({ offset: true }) に書き換えます。offset: true を付けないと、+09:00 付きの値は不正として拒否されます。

例:郵便番号検索 API の成功時とエラー時

zipcloud の郵便番号検索 API は、成功すると results に住所の配列を返し、エラーのときは message に文字列、results に null を入れて返します(ドキュメントの「エラー発生時のサンプル」)。成功時だけから作ったスキーマはエラー時のレスポンスを拒否するので、2 つのサンプル(成功時は 1 件に省略)を配列に入れて貼ります。ルート名は ZipcloudResponse です。

[{"message":null,"results":[{"address1":"北海道","address2":"美唄市","address3":"上美唄町協和","kana1":"ホッカイドウ","kana2":"ビバイシ","kana3":"カミビバイチョウキョウワ","prefcode":"1","zipcode":"0790177"}],"status":200},{"message":"必須パラメータが指定されていません。","results":null,"status":400}]

出力:

import { z } from "zod";

const ZipcloudResponseSchema = z.array(z.object({
    message: z.union([z.null(), z.string()]),
    results: z.union([z.array(z.object({
        address1: z.string(),
        address2: z.string(),
        address3: z.string(),
        kana1: z.string(),
        kana2: z.string(),
        kana3: z.string(),
        prefcode: z.string(),
        zipcode: z.string(),
      })), z.null()]),
    status: z.number().int(),
  }));

export type ZipcloudResponse = z.infer<typeof ZipcloudResponseSchema>;

message と results が null を含む union になり、両方のレスポンスが通ります。ルートが配列なので、出力全体は z.array(…) です。API のレスポンス 1 件を検証するには、z.array( と最後の ) を外して中の z.object(…) だけを使います。zipcode は先頭の 0 を保つために文字列のままにしておきます。

使う前に直すところ

生成結果問題修正(Zod 4)
email: z.string()どんな文字列も通るz.email()(Zod 3 は z.string().email())
qty: z.number().int()常に整数のときだけ正しい。10.5 は Invalid input: expected int, received number で失敗する価格は z.number() にし、.min(0) を足す
message: z.union([z.null(), z.string()])意味は合っているが読みにくいz.string().nullable()
status: z.number().int()どんな整数も通るz.union([z.literal(200), z.literal(400), z.literal(500)])
サンプルにあったフィールドAPI が省略することがあっても必須になる.optional() を付ける

失敗したら処理を止めたい場所(起動時の設定読み込みなど)では .parse() を使います。ZodError を投げます。API レスポンスやユーザー入力には .safeParse() を使います。{ success: false, error } を返すので、エラーを自分で処理できます。

制限事項

  • 型は貼ったサンプルだけから決まります。 空の配列は z.array(z.unknown())、空のオブジェクトは z.record(z.string(), z.unknown()) になります。
  • null は z.null() になります。 .nullable() は付きません。
  • 型が混ざった配列は union になります。 [{"a": 1}, 2] のような配列は z.array(z.union([z.number().int(), z.object({ a: z.number().int() })])) になります。同じ配列のオブジェクトは 1 つの z.object にまとまります。
  • 整数と小数が同じキーにあると union になります。 z.union([z.number(), z.number().int()]) は z.number() にまとめられます。
  • 大きな整数。 入力は JSON.parse で読むので、9007199254740991 を超える整数はスキーマを作る前に桁が変わります。
  • 文字列の形式や範囲は付きません。 メール、URL、日付、UUID はすべて z.string() です。
  • ネストが非常に深い JSON。 ブラウザのコールスタックを超えることがあり、その場合はステータスにエラーを表示し、前のスキーマを消去してコピーを無効にします。
  • 入力は有効な JSON である必要があります。 無効なときは出力が消えてコピーが無効になり、ステータスにエラーの行と列、考えられる原因が表示されます。行と列は入力したままのテキストで数えます。IME で入力した全角スペースが値の前に入った {"天気": "晴れ"} は 無効なJSON:1 行 7 列目、全角文字   があります。JSON の記号と空白は半角です。 になります(「全角文字」と「があります」の間に見える空白が、問題の全角スペース U+3000 です)。全角の : や “” も同じように位置が示されます。

FAQ

Zod とは何ですか?

Zod は TypeScript ファーストのスキーマ宣言・バリデーションライブラリです。データの形をスキーマで定義し、実行時にデータを検証できます。API レスポンスの検証、フォームのバリデーション、設定ファイルの読み込みによく使われます。

型の推論はどう行われますか?

各 JSON 値を調べます。文字列 → z.string()、真偽値 → z.boolean()、整数 → z.number().int()、小数 → z.number()、null → z.null()、配列 → z.array()、オブジェクト → z.object()。オブジェクトの配列では、一部の要素にしかないキーに .optional() を付け、要素によって型が違うキーは z.union にします。

ストリクトモードとは何ですか?

「ストリクトモード(余分なキーを禁止)」をオンにすると、ネストしたものも含めてすべての z.object() に .strict() が付きます。スキーマにないキーを含むオブジェクトは Zod に拒否されます。オフのときは、余分なキーはパース結果から黙って取り除かれます(Zod の既定の動作)。

出力は Zod 3 と Zod 4 の両方で使えますか?

使えます。生成器が使うのは z.object、z.array、z.union、z.record、z.string、z.number().int()、z.boolean、z.null、z.unknown、.optional()、.strict() だけで、どちらのバージョンにもあります。このページの例は、TypeScript の strict モードで Zod 3 と Zod 4 の API(zod/v4)の両方に対してコンパイルできることを確認しています。違いが 1 つあり、Zod 4 の z.number().int() は安全な整数の範囲(9007199254740991 以下)を超える整数も拒否します。

生成されたスキーマはそのまま使えますか?

生成スキーマは出発点です。文字列や数値への .min()/.max() の追加、null になりうるフィールドの .nullable().optional() への変更、ネストしたスキーマの個別定数への分割など、プロジェクトに合わせて調整してください。

JSON データはサーバーに送信されますか?

いいえ。ページはブラウザ内で JSON からスキーマを生成し、JSON をどこにも送信せず、ブラウザのストレージにも保存しません。ページのアクセス解析は、入力を編集してフォーカスが外れたとき、または「Zod スキーマを生成」「サンプル」をクリックしたときに利用イベント(ツール名と動作 generate)を 1 回記録するだけで、JSON や生成したコードは含みません。