JSON → TypeScript / Zod

JSON 形式の API レスポンスのサンプルから、TypeScript の型や Zod 4 の検証スキーマを生成します。

生成されたコード
有効な JSON を入力するとコードが生成されます。

フィールドの推定方法

変換ツールは、配列の要素をすべて確認します。この例では最初のレコードだけに active があるため、省略可能なフィールドになります。一方、name は両方のレコードにあり、一方の値は文字列、もう一方は null です。そのため、name は必須フィールドで、型は string | null になります。

[
  { "id": 1, "name": "Ada", "active": true },
  { "id": 2, "name": null }
]
export type ApiResponse = Array<{
  id: number
  name: string | null
  active?: boolean
}>

サンプルの配列が空の場合、要素の型は unknown になります。API が返すさまざまな構造のレコードをサンプルに含めると、実際のレスポンスに近い型を生成できます。

TypeScript と Zod の使い分け

TypeScript はエディターやコンパイル時の型チェックに使います。実行時に受け取ったデータを検証するには、Zod のスキーマで apiResponseSchema.safeParse(data) を呼び出します。生成された Zod ファイルは TypeScript の型もエクスポートします。指定された値や文字列の形式など、API 固有の制約があれば生成コードに追加してください。