ガイド
JSON から TypeScript・Zod・Pydantic v2 スキーマを自動生成して型安全を確保
API の JSON サンプルから TypeScript インターフェース、実行時 Zod バリデータ、Python Pydantic v2 BaseModel を省略可能・エイリアス推論付きで生成。
クイックアンサー: 実際の JSON レスポンスから `TypeScript` インターフェース、実行時 `Zod` スキーマ、`Pydantic v2` モデルを直接推論すれば、型ズレや必須項目の欠落を早期に防げます。TxtTo はユニオン型や任意フィールドをブラウザ内でローカル推論し、API データを送信しません。
API 境界ではコンパイル時の型定義だけでは不十分な理由
TypeScript の interface はコンパイル後の JavaScript からは消えてしまいます。外部 Webhook がキー名を変更したり予期しない `null` を返したりしても、静的な型だけでは実行時クラッシュを防げません。
コンパイル時の TypeScript モデルと実行時バリデータ(JS/TS なら Zod、Python なら Pydantic v2)を組み合わせることで、ペイロード全体の整合性を確実に保証できます。
TypeScript での省略可能キー(?)とユニオン型の自動推論
実際の API 配列では先頭要素にすべての任意プロパティが含まれているとは限りません。JSON to TypeScript は配列内の全要素を走査してプロパティを統合し、一部要素にしか存在しないキーには自動で `?` を付与します。
export interface EventItem {
id: string;
retries?: number;
error: string | null;
}Zod によるランタイム検証と z.infer 型導出の一元化
型定義とバリデーション処理を二重管理する代わりに、JSON to Zod はネストされた `z.object(...)` スキーマと `export type RootSchema = z.infer<typeof rootSchema>` を同時に生成し、実行時チェックと静的型を常に同期させます。
Python Pydantic v2 BaseModel と Field エイリアス自動付与
Web API の JSON は `camelCase` が主流ですが、Python の PEP 8 は `snake_case` を推奨します。JSON to Pydantic はネストされたクラスを上位に整理して出力し、`Optional[...]` ヒントと `Field(alias="camelKey")` を自動付与します。
class RootModel(BaseModel):
user_id: str = Field(alias="userId")
is_active: bool = Field(alias="isActive")参考文献
よくある質問
JSON のキー名にハイフン(-)や Python 予約語が含まれていたらどうなりますか?
TypeScript では不正な識別子を引用符で囲み("content-type")、Pydantic では安全な snake_case 属性名に変換した上で Field(alias=...) で元キーと紐付けます。
生成される Zod スキーマで厳格な .strictObject() / .strict() を使うべき場面は?
厳密な社内 API 契約テストではオンにし、項目が追加される可能性のある外部サードパーティ API を受ける場合はオフにして未知キーを許容するのが安全です。
型生成の前に末尾カンマ付きの崩れた JSON を整形・修復できますか?
はい。先に JSON Formatter で末尾カンマ除去とツリー確認を行い、「次のツールへ送る」からワンクリックで JSON to TypeScript へ引き継げます。
関連フォーマット
関連比較ページ
関連ガイド
- なぜサーバー送信型のオンライン整形ツールは危険なのか — ゼロアップロード設計の仕組み.env・JWT・顧客 CSV・契約書を外部変換サイトへ貼る危険性と、DevTools Network タブで送信量 0 バイトを確認できる仕組みを解説します。
- XML から JSON への変換:属性・CDATA・RSS フィードを保持する実践ガイドXML・RSS・SVG をブラウザメモリ内で JSON に変換し、@_ 属性や CDATA テキスト、数値型を保持したまま XML への往復変換も行えます。
- オフライン JWT デコード・Base64URL・セマンティック JSON Diff ガイド送信ゼロのブラウザメモリ上で JWT のヘッダーとクレームをデコードし、パディングなし Base64URL 変換やキー順を問わないセマンティック JSON Diff、ログ秘匿化を実行。