JSON → TypeScript 생성기
JSON에서 TypeScript 인터페이스를 자동 생성. 중첩 객체, 배열, 유니언 타입, 선택적 속성 지원. 브라우저에서 처리, 무료.
- 브라우저에서 처리
- 도구 입력을 ZeroTool 서버에 업로드하지 않습니다
- 무료 · 회원가입 불필요
WeChat으로 스캔하여 공유
예시·자세한 설명·자주 묻는 질문 실제 출력이 있는 예시, 다른 도구와의 차이, 자주 묻는 질문.
예시: 카카오 로컬 API 키워드 장소 검색 응답
카카오 로컬 API 개발 가이드의 ‘키워드로 장소 검색’ 응답 예제에서 문서 하나만 남겨 붙여 넣고, 루트 인터페이스 이름을 KeywordSearchResponse로 지정합니다.
{
"meta": {
"same_name": {
"region": [],
"keyword": "카카오프렌즈",
"selected_region": ""
},
"pageable_count": 14,
"total_count": 14,
"is_end": true
},
"documents": [
{
"place_name": "카카오프렌즈 코엑스점",
"distance": "418",
"place_url": "http://place.map.kakao.com/26338954",
"category_name": "가정,생활 > 문구,사무용품 > 디자인문구 > 카카오프렌즈",
"address_name": "서울 강남구 삼성동 159",
"road_address_name": "서울 강남구 영동대로 513",
"id": "26338954",
"phone": "02-6002-1880",
"category_group_code": "",
"category_group_name": "",
"x": "127.05902969025047",
"y": "37.51207412593136"
}
]
}
생성 결과:
interface KeywordSearchResponse {
meta: Meta;
documents: DocumentsItem[];
}
interface Meta {
same_name: Same_name;
pageable_count: number;
total_count: number;
is_end: boolean;
}
interface Same_name {
region: unknown[];
keyword: string;
selected_region: string;
}
interface DocumentsItem {
place_name: string;
distance: string;
place_url: string;
category_name: string;
address_name: string;
road_address_name: string;
id: string;
phone: string;
category_group_code: string;
category_group_name: string;
x: string;
y: string;
}
결과를 문서의 응답 표와 맞춰 보면 고칠 곳이 보입니다.
x,y,distance는 숫자처럼 보여도 문서에서 String으로 정의되어 있고 JSON에서도 문자열이므로string이 맞습니다. 거리를 비교하거나 계산하려면Number()로 바꿔야 합니다.region은 예제에서 빈 배열이라unknown[]이 되었습니다. 문서의 타입은 String[]이므로string[]로 고칩니다.same_name키에서 만든 이름은Same_name입니다. 밑줄 뒤의 글자는 대문자가 되지 않으므로, 문서처럼SameName으로 바꾸면 읽기 쉽습니다.
예시: 두 응답의 meta 합치기
같은 문서의 ‘카테고리로 장소 검색’ 응답 예제에서는 same_name이 null입니다. 키워드 검색 하나만 보고 만든 타입으로는 이 응답을 받을 수 없습니다. 두 응답의 meta를 배열에 넣어 붙여 넣으면 요소들이 합쳐지고, 요소 하나의 타입이 루트 이름(Meta)으로 출력됩니다.
[
{"same_name": {"region": [], "keyword": "카카오프렌즈", "selected_region": ""}, "pageable_count": 14, "total_count": 14, "is_end": true},
{"same_name": null, "pageable_count": 11, "total_count": 11, "is_end": true}
]
생성 결과:
interface Meta {
same_name: (null | Same_name);
pageable_count: number;
total_count: number;
is_end: boolean;
}
interface Same_name {
region: unknown[];
keyword: string;
selected_region: string;
}
same_name이 null과 객체의 유니언 타입이 되어 두 응답을 모두 받습니다. 키가 모든 요소에 있으므로 ?는 붙지 않습니다.
예시: 한글 키
사내 시스템이나 엑셀에서 변환한 JSON은 한글 키를 쓰기도 합니다. 루트 이름을 회원으로 지정하면:
{"이름":"홍길동","연락처":{"휴대전화":"010-1234-5678","이메일":"hong@example.com"},"관심분야":["개발","디자인"]}
생성 결과:
interface 회원 {
"이름": string;
"연락처": 연락처;
"관심분야": string[];
}
interface 연락처 {
"휴대전화": string;
"이메일": string;
}
속성 이름은 따옴표로 감싸고(도구는 ASCII 영문자, 숫자, _, $로만 된 키만 식별자로 봅니다), 인터페이스 이름은 한글 그대로 씁니다. 둘 다 TypeScript에서 유효합니다. 휴대전화 번호는 앞자리 0이 있으므로 문자열로 두어야 합니다.
직접 다듬을 부분
- 객체 속성의
null은?: null이 되고, 객체 배열의 모든 요소에서null인 키는?없이null이 됩니다. 문서를 확인해string | null같은 실제 타입으로 바꿉니다. - 숫자는 정수와 소수를 구분하지 않고
number입니다. - 날짜: ISO 8601 문자열과 Unix 타임스탬프는 각각
string,number로 남습니다. - 같은 키 이름에 필드가 다른 객체가 둘 있으면 두 번째에는 부모 이름이 붙고(
payment.meta는PaymentMeta), 그 이름도 쓰이고 있으면 숫자가 붙습니다(Meta2). 루트는 지정한 이름을 유지합니다. - 올바른 타입 이름이 되지 않는 키(
2fa, 빈 키)는 인터페이스 이름 앞에T를 붙입니다(T2fa).
제한 사항
- 입력은 유효한 JSON이어야 합니다(주석, 끝 쉼표 불가). 유효하지 않으면 출력이 지워지고, 상태 표시에 몇 행 몇 열인지와 예상 원인이 나옵니다. 행과 열은 입력한 그대로의 텍스트에서 셉니다. 예를 들어
{"a":1,}은잘못된 JSON: 1행 7열, 닫는 괄호 앞에 쉼표가 남아 있습니다.로 표시됩니다. 문서에서 복사해 둥근 따옴표가 섞인{“이름”: "홍길동"}은잘못된 JSON: 1행 2열, “는 둥근 따옴표입니다. 곧은 큰따옴표(")를 쓰세요.로 표시됩니다. - 루트 배열에 객체와 다른 값이 섞여 있으면(
[{"id": 1}, "x", null]등) 객체는 루트 이름의 인터페이스로 합쳐지고, 배열 전체를 나타내는 타입 별칭이 중첩 배열과 같은 방식으로 추가됩니다:type RootObjectArray = (string | null | RootObject)[];. 응답 타입에는RootObjectArray를 씁니다. - 루트 인터페이스 이름은 ECMAScript 식별자 규칙으로 정리합니다. 각 언어의 문자, 숫자,
$,_는 남기고, 그 밖의 문자는 지운 뒤 다음 글자를 대문자로 바꿉니다(user profile은userProfile). 식별자 첫 글자로 쓸 수 없는 이름은 앞에T를 붙이고(2fa는T2fa), 예약어나 기본 타입 이름은 뒤에_를 붙입니다(class는class_). 남는 글자가 없으면 RootObject를 씁니다. - TypeScript 표준 라이브러리(
lib.dom.d.ts와 각lib.es*.d.ts)에 있는 한 단어짜리 전역 타입(Promise,Date,Map,Record,Body,Response,Event,JSON,URL등)과 같은 이름은 그대로 쓰지 않습니다.import나export가 없는 파일에서는 그 선언이 전역 타입과 병합되고, 모듈에서는 전역 타입을 가리기 때문입니다. 중첩 객체는 앞에 부모 이름을 붙이고({"date": {"year": 2026}}는RootObjectDate,"URL"키는RootObjectURL."url"키에서 만들어지는Url은 전역 타입이 아니므로 그대로입니다), 루트 이름에는_를 붙입니다(Map은Map_). 루트 이름globalThis에도_를 붙입니다(globalThis_).import나export가 없는 파일에서는 TypeScript가 이 이름의 선언을 받아들이지 않기 때문입니다.Image,Intl,Proxy처럼 전역 값으로만 있는 이름은 같은 이름의 interface나 type과 충돌하지 않으므로 그대로 씁니다. formData키에서 만들어지는FormData처럼 여러 단어로 된 전역 타입 이름은 생성된 이름 그대로입니다.import나export가 없는 파일에 붙여 넣거나, 붙여 넣을 모듈에서 그 전역 타입도 쓴다면 이름을 바꾸세요.- 중첩이 아주 깊으면 브라우저의 호출 스택을 넘을 수 있습니다. 이때 상태 표시에 오류가 나오고 이전 출력은 지워집니다.
- 9007199254740991(
Number.MAX_SAFE_INTEGER)보다 큰 정수는JSON.parse에서 자릿수가 바뀌고 타입은number가 됩니다. - 타입은 붙여 넣은 샘플에서만 정해집니다. 샘플에서는 문자열이지만 실제로는 가끔 숫자인 필드도
string으로 남습니다. - interface 대신 type 사용을 선택하면 각 선언이
type Name = { ... }로 출력되지만 상태 표시는 ‘인터페이스’ 그대로입니다.
FAQ
이 도구는 무엇을 생성하나요?
JSON 객체에서 TypeScript interface(또는 type 별칭) 선언을 생성합니다. 중첩된 객체는 각각 이름이 붙은 별도 인터페이스가 되고, 배열에 여러 타입이 섞여 있으면 유니언 타입이 됩니다.
중첩 객체는 어떻게 처리되나요?
중첩된 객체마다 키 이름을 PascalCase로 바꾼 이름의 인터페이스를 따로 만듭니다. 예를 들어 address는 Address가 되고, 부모 인터페이스는 그 이름으로 참조합니다. 하이픈, 공백 같은 구분자 뒤의 글자만 대문자가 되므로 user-info는 UserInfo, same_name은 Same_name이 됩니다. 한글 키는 그대로 타입 이름이 됩니다(예: 연락처). Date, Response처럼 TypeScript의 한 단어짜리 전역 타입과 같은 이름이 되면 앞에 부모 이름을 붙입니다(RootObjectDate).
객체 배열은 어떻게 처리되나요?
배열 안의 객체를 모두 합쳐 하나의 요소 인터페이스를 만듭니다. 일부 요소에만 있는 필드에는 ?가 붙고, 요소마다 타입이 다른 필드는 (null | string) 같은 유니언 타입이 됩니다.
‘속성을 선택적으로 설정’은 어떤 옵션인가요?
켜면 생성되는 모든 인터페이스의 모든 속성에 ?가 붙어 선택적 속성이 됩니다. 일부 필드만 오는 데이터를 받거나 느슨한 타입이 필요할 때 씁니다. 바꾼 뒤에는 TypeScript 생성을 클릭해야 적용됩니다.
interface와 type은 무엇이 다른가요?
둘 다 객체의 형태를 선언할 수 있습니다. interface는 선언 병합을 지원하며 객체 타입에 흔히 쓰는 방식이고, type은 기본 타입, 유니언 타입, 튜플도 표현할 수 있습니다. ‘interface 대신 type 사용’으로 바꿀 수 있습니다.
데이터가 서버로 전송되나요?
아니요. 페이지는 브라우저 안에서 JSON의 타입을 추론하며, JSON을 어디로도 보내지 않고 브라우저 저장소에도 저장하지 않습니다. 페이지 통계는 입력을 고친 뒤 포커스가 입력란을 벗어날 때, 또는 TypeScript 생성이나 예시를 클릭할 때 사용 이벤트(도구 이름과 동작 generate)를 한 번 기록할 뿐이며 JSON이나 생성된 코드는 포함하지 않습니다.