JSON to Zod 스키마 변환기

Zod 스키마란 무엇인가요?

예시

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

JSON을 Zod로 변환하는 방법

1. 1

   JSON 붙여넣기

   JSON 객체, 배열 또는 API 응답을 입력 상자에 넣으세요. 변환이 즉시 시작됩니다.

2. 2

   출력 조정

   루트 스키마의 이름을 바꾸고 import 줄, z.infer 타입, export 키워드를 토글하여 프로젝트 스타일에 맞추세요.

3. 3

   복사 또는 다운로드

   생성된 Zod 스키마를 한 번의 클릭으로 가져와 검증 계층에 바로 붙여넣으세요.

Common Use Cases

API 응답 검증

샘플 REST나 GraphQL 응답을 Zod 스키마로 바꿔 fetch 경계에서 파싱하면, 잘못된 데이터가 앱으로 새어 들지 않고 명확한 오류로 빠르게 실패합니다.

타입 안전한 폼과 입력

폼이나 쿼리 입력의 스키마를 생성하고 UI와 핸들러 전반에서 z.infer 타입을 재사용하여 엔드투엔드 타입 안전성을 얻으세요.

tRPC와 AI 도구 스키마

예시 페이로드에서 tRPC 프로시저나 AI 구조화 출력 도구의 입력·출력 스키마를 손으로 쓰지 않고 부트스트랩하세요.

변환이 작동하는 방식

구조적 추론

각 객체는 명명된 스키마가 되며, 동일한 형태는 한 번만 선언되어 재사용됩니다. 객체 배열은 키 단위로 병합되고, 일부 항목에 없는 키는 .optional()이 됩니다.

올바른 타입 매핑

정수는 z.number().int()로, 소수는 z.number()로 매핑됩니다. 문자열, 불리언, null은 각각 z.string(), z.boolean(), z.null()로 매핑되고, 원시 타입이 섞인 배열은 z.union()이 됩니다.

TypeScript 타입 포함

루트 스키마에 z.infer 타입 별칭이 방출되므로 스키마가 유일한 정보 출처로 유지되고 타입이 검증에서 어긋나지 않습니다.

100% 클라이언트 측

파싱과 생성이 네트워크 호출 없이 브라우저에서 실행되므로 데이터가 비공개로 유지됩니다.

깔끔한 Zod 스키마를 위한 팁

루트 스키마 이름 짓기

읽기 쉽고 자체 문서화되는 코드를 위해 기본값 Root 대신 User나 ApiResponse 같은 의미 있는 루트 이름을 설정하세요.

z.unknown()과 유니온 정교화

비어 있거나 혼합된 배열은 z.unknown()이나 광범위한 z.union()을 생성합니다. 더 풍부하고 대표적인 샘플을 붙여넣어 도구가 정확한 타입을 추론하게 한 다음, 모호하게 남는 부분을 좁히세요.

경계에서 검증하기

신뢰할 수 없는 데이터가 들어오는 곳 — API 응답, 폼 입력, 웹훅 — 에서 safeParse()를 호출하여, 잘못된 데이터가 애플리케이션 로직에 도달하기 전에 잡으세요.

자주 묻는 질문