JSON naar Zod-schema omzetter

Wat is een Zod-schema?

Voorbeelden

{"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>;

Zo zet je JSON om naar Zod

1. 1

   Plak je JSON

   Zet een JSON-object, array of API-respons in het invoerveld. De conversie start direct.

2. 2

   Stem de uitvoer af

   Hernoem het root-schema en schakel de import-regel, het z.infer-type of het export-sleutelwoord om, passend bij de stijl van je project.

3. 3

   Kopieer of download

   Haal het gegenereerde Zod-schema met één klik op en plak het rechtstreeks in je validatielaag.

Common Use Cases

API-responses valideren

Zet een voorbeeldrespons van REST of GraphQL om in een Zod-schema en parse die op de fetch-grens, zodat misvormde data snel faalt met een duidelijke fout in plaats van door je app te lekken.

Typeveilige formulieren en invoer

Genereer een schema voor formulier- of query-invoer en hergebruik het z.infer-type in je UI en handlers voor end-to-end-typeveiligheid.

tRPC- en AI-tool-schema's

Genereer invoer- en uitvoerschema's voor tRPC-procedures of AI-tools met gestructureerde uitvoer uit een voorbeeldpayload in plaats van ze met de hand te schrijven.

Hoe de conversie werkt

Structurele afleiding

Elk object wordt een benoemd schema; identieke vormen worden eenmaal gedeclareerd en hergebruikt. Arrays van objecten worden sleutel voor sleutel samengevoegd, en sleutels die in sommige items ontbreken, worden .optional().

Correcte typetoewijzing

Gehele getallen worden z.number().int() en decimalen z.number(). Strings, booleans en null-waarden worden z.string(), z.boolean() en z.null(); een array van gemengde primitieven wordt een z.union().

TypeScript-typen inbegrepen

Voor het root-schema wordt een z.infer-type-alias uitgegeven, zodat het schema de enige bron van waarheid blijft en je typen nooit afwijken van je validatie.

100% aan de clientzijde

Het parsen en genereren draait in je browser zonder netwerkaanroepen, zodat je data privé blijft.

Tips voor schone Zod-schema's

Geef je root-schema een naam

Stel een betekenisvolle rootnaam in zoals User of ApiResponse in plaats van de standaard Root voor leesbare, zelfdocumenterende code.

Verfijn z.unknown() en unions

Lege of gemengde arrays produceren z.unknown() of een brede z.union(). Plak een rijker, representatief voorbeeld zodat de tool precieze typen afleidt, en scherp daarna alles aan wat dubbelzinnig blijft.

Valideer aan de grens

Roep safeParse() aan waar niet-vertrouwde data binnenkomt — API-responses, formulierinvoer, webhooks —, zodat foute data wordt opgevangen voordat ze je applicatielogica bereikt.

Veelgestelde vragen