JSON zu Zod Schema Konverter

Was ist ein Zod-Schema?

Beispiele

{"id":101,"name":"Ada Lovelace","email":"ada@example.com","active":true,"roles":["admin","user"]}

import { z } from "zod";

export const RootSchema = z.object({
  id: z.number().int(),
  name: z.string(),
  email: z.string(),
  active: z.boolean(),
  roles: z.array(z.string()),
});

export type Root = z.infer<typeof RootSchema>;

{"repo":"zod","owner":{"login":"colinhacks","id":100}}

import { z } from "zod";

export const OwnerSchema = z.object({
  login: z.string(),
  id: z.number().int(),
});

export const RootSchema = z.object({
  repo: z.string(),
  owner: OwnerSchema,
});

export type Root = z.infer<typeof RootSchema>;

{"users":[{"id":1,"nick":"x"},{"id":2}]}

import { z } from "zod";

export const UserSchema = z.object({
  id: z.number().int(),
  nick: z.string().optional(),
});

export const RootSchema = z.object({
  users: z.array(UserSchema),
});

export type Root = z.infer<typeof RootSchema>;

{"items":[{"sku":"A1","discount":0.1},{"sku":"A2","discount":null}]}

import { z } from "zod";

export const ItemSchema = z.object({
  sku: z.string(),
  discount: z.number().nullable(),
});

export const RootSchema = z.object({
  items: z.array(ItemSchema),
});

export type Root = z.infer<typeof RootSchema>;

So konvertieren Sie JSON nach Zod

1. 1

   JSON einfügen

   Fügen Sie ein JSON-Objekt, ein Array oder eine API-Antwort in das Eingabefeld ein. Die Konvertierung startet sofort.

2. 2

   Ausgabe anpassen

   Benennen Sie das Root-Schema um und schalten Sie die import-Zeile, den z.infer-Typ oder das export-Schlüsselwort um, passend zum Stil Ihres Projekts.

3. 3

   Kopieren oder herunterladen

   Übernehmen Sie das erzeugte Zod-Schema mit einem Klick und fügen Sie es direkt in Ihre Validierungsschicht ein.

Common Use Cases

API-Antworten validieren

Verwandeln Sie eine Beispielantwort von REST oder GraphQL in ein Zod-Schema und parsen Sie sie an der Fetch-Grenze, sodass fehlerhafte Daten schnell mit einem klaren Fehler scheitern, statt durch Ihre App zu sickern.

Typsichere Formulare und Eingaben

Erzeugen Sie ein Schema für Formular- oder Query-Eingaben und verwenden Sie den z.infer-Typ über Ihre UI und Handler hinweg wieder für durchgängige Typsicherheit.

tRPC- und KI-Tool-Schemas

Erstellen Sie Eingabe- und Ausgabeschemas für tRPC-Prozeduren oder KI-Tools mit strukturierter Ausgabe aus einem Beispiel-Payload, statt sie von Hand zu schreiben.

Wie die Konvertierung funktioniert

Strukturelle Inferenz

Jedes Objekt wird zu einem benannten Schema; identische Formen werden einmal deklariert und wiederverwendet. Arrays von Objekten werden Schlüssel für Schlüssel zusammengeführt, und Schlüssel, die in manchen Elementen fehlen, werden zu .optional().

Korrekte Typzuordnung

Ganzzahlen werden zu z.number().int() und Dezimalzahlen zu z.number(). Strings, Booleans und null-Werte werden zu z.string(), z.boolean() und z.null(); ein Array aus gemischten Primitiven wird zu einem z.union().

TypeScript-Typen inklusive

Für das Root-Schema wird ein z.infer-Typ-Alias ausgegeben, sodass das Schema die einzige Quelle der Wahrheit bleibt und Ihre Typen nie von Ihrer Validierung abweichen.

100 % clientseitig

Parsing und Generierung laufen in Ihrem Browser ohne Netzwerkaufrufe, sodass Ihre Daten privat bleiben.

Tipps für saubere Zod-Schemas

Benennen Sie Ihr Root-Schema

Vergeben Sie einen aussagekräftigen Root-Namen wie User oder ApiResponse statt des Standards Root für lesbaren, selbstdokumentierenden Code.

z.unknown() und Unions verfeinern

Leere oder gemischte Arrays erzeugen z.unknown() oder ein breites z.union(). Fügen Sie ein reichhaltigeres, repräsentatives Beispiel ein, damit das Werkzeug präzise Typen ableitet, und schärfen Sie dann alles nach, was mehrdeutig bleibt.

An der Grenze validieren

Rufen Sie safeParse() dort auf, wo nicht vertrauenswürdige Daten eintreffen — API-Antworten, Formulareingaben, Webhooks —, damit fehlerhafte Daten abgefangen werden, bevor sie Ihre Anwendungslogik erreichen.

Häufig gestellte Fragen