본문으로 건너뛰기
스키마 도구

JSON → Zod 스키마 생성

JSON 샘플에서 Zod 스키마를 만듭니다. import { z } from 'zod', z.object({...}) 스키마, z.infer로 타입을 꺼내는 한 줄이 출력되므로 그대로 붙여 schema.parse(data)로 API 응답 등을 검증할 수 있습니다. 배열 요소의 모양이 다르면 하나로 합치고 일부 요소에만 있는 키는 .optional(), "문자열 또는 null" 같은 값은 .nullable()이 됩니다. 빈 배열은 z.array(z.unknown())입니다. 숫자는 정수든 소수든 z.number(), 날짜 문자열도 z.string()이므로 .int()·.datetime()이나 글자 수·범위 제약은 직접 추가하세요. 샘플 하나에서 추론합니다. 모든 처리는 브라우저 안에서 이루어지며 JSON은 전송되지 않습니다.

다른 검증기: Valibot, JSON Schema

같은 JSON에서 Valibot 스키마나 JSON Schema(draft 2020-12)를 만듭니다. 배열 요소는 하나로 합쳐지고 일부 객체에만 있는 키는 선택 항목이 됩니다. 위의 문자열 형식 옵션과 루트 이름도 반영됩니다.

가이드

사용 방법 및 특징

  • 입력 칸에 JSON을 붙여넣고 “Zod로 변환”을 누릅니다.
  • 객체는 `z.object({...})` 형태로 정리되며, 중첩 구조도 자동 생성됩니다.
  • 배열은 요소 타입을 추론하고, 여러 타입이 섞이면 `z.union([...])`으로 표현합니다.
  • 복사 또는 지우기 버튼으로 결과를 재사용하거나 다시 시작하세요.
샘플

입출력 예시

Convert JSON to Zod schema

입력 예시
{"id":42,"enabled":false,"labels":["alpha","beta"]}
출력 예시
const Schema = z.object({
    id: z.number(),
    enabled: z.boolean(),
    labels: z.array(z.string()),
});
FAQ

자주 묻는 질문

  • 어떤 코드가 출력되나요?

    `import { z } from 'zod'`, `z.object({...})` 스키마, `z.infer`로 타입을 꺼내는 한 줄의 세 가지입니다. 그대로 프로젝트에 붙여 `schema.parse(data)`로 검증할 수 있습니다.
  • 배열 요소의 모양이 다르면 어떻게 되나요?

    요소를 하나의 타입으로 합칩니다. 일부 요소에만 있는 키는 `.optional()`이 됩니다. 문자열과 숫자처럼 값의 종류가 다를 때만 `z.union`이 됩니다.
  • `null`은 어떻게 처리되나요?

    "문자열 또는 null" 같은 경우에는 `.nullable()`을 붙입니다. 값이 `null`뿐인 키는 `z.null()`이 됩니다.
  • 정수나 날짜는 `.int()`나 `.datetime()`이 되나요?

    되지 않습니다. 숫자는 정수든 소수든 `z.number()`, 날짜 문자열도 `z.string()`입니다. 필요한 제약은 출력에 직접 추가하세요.
  • 빈 배열은 어떻게 되나요?

    요소 타입을 알 수 없으므로 `z.array(z.unknown())`이 됩니다. 실제 데이터의 타입으로 바꿔 주세요.
  • 입력한 JSON이 전송되나요?

    전송되지 않습니다. 변환은 모두 브라우저 안에서 이루어집니다.
활용

주요 활용 사례

  • 폼 검증 초안 작성

    백엔드 예시에서 Zod 스키마를 생성해 프런트엔드 검증 로직에 바로 적용합니다.
  • 목 데이터 검증

    로컬 목 JSON을 Zod로 파싱해 예상치 못한 필드나 구조를 런타임에 잡아냅니다.
  • 스키마 조각 공유

    생성된 조각을 복사해 여러 라이브러리에서 재사용하고, 런타임 검사를 타입과 일치시킵니다.
주의

주의 사항·제한

  • 샘플 하나에서 추론합니다

    JSON에 나타난 값의 "모양"만 보고 만듭니다. 가능한 값의 범위, 열거형(enum), 글자 수, 이메일 형식 같은 제약은 알 수 없습니다. 사양에 맞게 고치세요.
  • 필수 여부는 샘플에 따라 달라집니다

    배열의 모든 요소에 있는 키는 필수, 일부에만 있는 키는 `.optional()`이 됩니다. 실제 사양과 맞는지 확인하세요.
  • 정수·날짜 제약은 들어가지 않습니다

    `z.number()`와 `z.string()` 그대로입니다. 정수로 제한하려면 `.int()`, 날짜라면 `.datetime()` 등을 추가하세요.
  • 입력은 엄격한 JSON만 가능합니다

    주석이나 끝의 쉼표 등 JSON이 아닌 표기는 오류가 됩니다. JavaScript가 정확히 다루지 못하는 큰 정수는 반올림됩니다.
소개

이 도구에 대하여

JSON에서 Zod 스키마 생성

샘플 JSON을 기반으로 Zod schema를 생성해 런타임 검증 코드를 빠르게 준비할 수 있습니다. 외부 API, form, webhook, storage에서 들어오는 데이터를 사용하기 전에 구조를 확인할 때 유용합니다.

자주 쓰는 상황

  • 외부 API 검증: 실제 응답에서 schema 초안을 만듭니다.
  • 입력 경계 보호: 앱 내부로 들어오기 전 데이터를 확인합니다.
  • 테스트 준비: 예상 payload 구조를 schema로 문서화합니다.

샘플에 없는 optional field, enum, nullable 값은 실제 계약에 맞게 조정해야 합니다.

이 도구의 관련 기사

도구 소개
2026-01-11

Zod를 사용하여 JSON 유효성 검사 간소화하기

TypeScript 친화적인 스키마 정의 라이브러리인 'Zod'를 사용하여 JSON 데이터의 런타임 유효성 검사와 타입 생성을 자동화하는 방법을 소개합니다.

도구 소개
2026-08-06

JSON Schema와 Zod를 상호 변환하는 원리|required와 .optional()의 대응

JSON Schema와 Zod 스키마를 양방향으로 변환하는 변환기의 구현을 해설합니다. required와 .optional()의 기본값이 반대인 문제, 제약 조건 대응표, 코드를 실행하지 않고 해석하는 방법을 다룹니다.

도구 소개
2026-05-02

JSON 포맷팅과 검증: API 응답을 안전하게 확인하는 방법

JSON을 보기 좋게 정리하고, 문법 오류와 값의 타입을 확인하며, TypeScript 타입과 Zod, OpenAPI 스키마로 이어지는 실무 흐름을 설명합니다.

도구 소개
2026-02-16

JSON 에코시스템 입문: 포맷팅·타입 생성·검증·API 정의를 예제로 잇기

JSON을 기점으로 TypeScript 타입, Zod 런타임 검증, OpenAPI 정의로 전개하는 일련의 흐름을 실제 코드로 이어 해설. 타입 안전한 API 개발의 전체 그림을 알 수 있습니다.

도구 소개
2026-01-11

JSON에서 TypeScript 타입을 자동 생성하는 방법: 실제 예제로 배우는 변환 요령

API 응답 JSON을 타입 안전한 TypeScript 인터페이스로 변환하는 절차를 실제 변환 예제와 함께 해설. null·배열·중첩·명명 요령과 수동 보정까지 다룹니다.

최신 아티클