1. 홈
  2. 개발자
  3. JSON TypeScript 변환

JSON TypeScript 변환

API 응답 JSON을 붙여넣으면 타입과 검증 스키마가 바로 나옵니다.

내 브라우저에서 처리 · 업로드 없음
샘플이 적으면 선택 속성을 못 잡습니다. 여러 응답을 배열로 묶어 넣으면 더 정확해요.
null 값 처리
만든 타입
5
필드
20
입력 크기
0.4 KB
결과
export interface Root { id: number; name: string; email: string; isActive: boolean; createdAt: string; // ISO date shipping_address: ShippingAddress; tags: string[]; orders: Order[]; } export interface ShippingAddress { city: string; zip: string; coords: Coords; } export interface Coords { lat: number; lng: number; } export interface Order { id: number; total: number; couponCode?: null; items: Item[]; memo?: string; } export interface Item { sku: string; qty: number; }

사용 방법

  1. 입력칸에 JSON 샘플을 붙여넣습니다. API 응답 한 건이나 여러 건을 묶은 배열 모두 됩니다.
  2. 출력 형식에서 TS interface, TS type, Zod, JSON Schema 중 하나를 고르면 같은 분석 결과로 코드가 바뀝니다.
  3. 루트 이름, null 값 처리 방식, export·readonly, 날짜 감지 같은 옵션을 맞춥니다.
  4. 결과를 복사하거나 .ts(JSON Schema는 .json) 파일로 저장합니다.

추론 규칙

입력 결과
객체 이름 있는 interface. 루트는 루트 이름, 하위는 키를 PascalCase로 바꾼 이름(shipping_address → ShippingAddress)
객체가 든 배열 모든 원소의 키를 합쳐 하나의 타입으로. 일부 원소에만 있는 키는 선택 속성(?)
배열 이름 키 이름을 단수로 바꿔 사용(users → User, categories → Category, addresses → Address). 단순 규칙이라 news는 New가 되니 필요하면 직접 고치세요
같은 키의 타입이 다름 유니온(number | string)
같은 구조의 객체 키 순서와 상관없이 하나의 타입을 재사용. 이름이 겹치면 Item2처럼 숫자를 붙임
빈 배열 unknown[]
값이 섞인 배열 (string | number)[]
null 기본은 유니온(string | null), 모든 값이 null이면 null. 옵션으로 선택 속성이나 unknown으로 바꿀 수 있음
식별자가 아닌 키 따옴표로 감쌈("first-name": string)
날짜 문자열 표준 형식이면 // ISO date 주석(Zod는 z.string().datetime())

날짜로 보는 형식은 2026-10-07T12:00:00Z처럼 시간대(Z 또는 +09:00)가 붙은 일시와 2026-10-07 같은 날짜만 있는 문자열입니다. 시간대가 없는 일시는 datetime()이 통과시키지 않으므로 일반 문자열로 둡니다.

예시

{"users":[{"id":1,"email":"a@x.com"},{"id":2,"phone":null}]}를 변환하면 두 번째 원소에만 phone이, 첫 번째에만 email이 있으므로 둘 다 선택 속성이 됩니다.

export interface Root {
  users: User[];
}

export interface User {
  id: number;
  email?: string;
  phone?: null;
}

{"id":7,"name":"Kim","createdAt":"2026-10-07T12:00:00Z","tags":[]}를 Zod로 바꾸고 정수에 .int()를 켜면 다음과 같습니다.

export const RootSchema = z.object({
  id: z.number().int(),
  name: z.string(),
  createdAt: z.string().datetime(),
  tags: z.array(z.unknown()),
});

알아 둘 점

  • 샘플이 적으면 선택 속성을 못 잡습니다. 응답 하나만 넣으면 그 응답에 있는 키는 모두 필수로 보입니다. 여러 응답을 배열 하나로 묶어 넣으면 빠진 키와 null을 찾아냅니다.
  • 빈 배열과 null만 있는 값은 타입을 알 수 없습니다. unknown[], null로 나오니 실제 타입을 직접 적어 주세요.
  • 숫자는 정수와 실수를 구분하지 않습니다. TypeScript는 number이고, Zod에서만 모든 샘플이 정수일 때 .int()를 붙일 수 있습니다.
  • interface와 type: 객체 모양만 쓴다면 거의 같습니다. interface는 나중에 같은 이름으로 확장할 수 있고, type은 유니온·튜플 같은 다른 형태와 같은 문법으로 쓸 수 있습니다.
  • Zod를 쓰는 이유: TypeScript 타입은 컴파일할 때만 존재해서 실제 서버 응답이 달라져도 막지 못합니다. Zod 스키마로 parse하면 실행 중에 모양을 검사하고, z.infer로 같은 타입도 얻습니다.
  • JSON Schema는 draft 2020-12 형식이며, 선택 속성은 required에서 빠지고 하위 객체는 $defs로 나뉩니다.
  • 입력은 2MB, 중첩은 64단계까지 처리합니다.

관련 도구

문법 오류부터 확인하려면 JSON 포맷터, 형식을 바꾸려면 JSON ↔ YAML 변환과 JSON ↔ CSV 변환, 두 응답의 차이는 JSON 비교로 볼 수 있습니다.

입력한 글은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.

필요한 도구가 없나요?

어떤 작업을 하고 싶은지 적어 주세요. 요청이 많은 도구부터 만듭니다.