사용 방법
- 입력칸에 JSON 샘플을 붙여넣습니다. API 응답 한 건이나 여러 건을 묶은 배열 모두 됩니다.
- 출력 형식에서 TS interface, TS type, Zod, JSON Schema 중 하나를 고르면 같은 분석 결과로 코드가 바뀝니다.
- 루트 이름, null 값 처리 방식,
export·readonly, 날짜 감지 같은 옵션을 맞춥니다. - 결과를 복사하거나
.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 비교로 볼 수 있습니다.
입력한 글은 브라우저 안에서만 처리되며 서버로 전송되지 않습니다.