JSON 입력
구성
TypeScript 출력
TypeScript 출력이 여기에 표시됩니다
옵션을 구성하고 JSON을 입력하여 생성하세요
이 도구에 대해
API 작업 시 타입이 없는 JSON 응답을 다루는 경우가 많습니다. 이 변환기는 원시 JSON을 받아 코드베이스에 바로 사용할 수 있는 구조화된 TypeScript 정의를 생성합니다. 주요 기능: • 다양한 입력 모드: 단일 JSON, 병합된 타입을 위한 다중 샘플, JSON Schema, Postman 컬렉션 • 인터페이스 또는 타입 별칭 출력, 이름 지정 완전 제어 • PascalCase 변환, 선택적 속성, readonly 수정자 • 중첩된 객체와 배열 처리 및 올바른 타입 추론 • 입력 중 실시간 변환 — 버튼 클릭 불필요
사용 방법
1. 왼쪽 패널에 JSON을 붙여넣거나 업로드 2. 구성 열에서 루트 타입 이름 설정 (기본값 'Root') 3. 소스 타입 선택 — 일반 JSON이 대부분의 경우에 적합 4. 인터페이스 vs 타입, 선택적 속성, readonly 등 변환 옵션 전환 5. TypeScript 출력이 오른쪽에 즉시 표시 6. 결과를 복사하거나 .ts 파일로 다운로드
일반적인 사용 사례
API 통합
REST API 응답 페이로드를 타입이 지정된 인터페이스로 변환하여 fetch 래퍼와 SDK 클라이언트에 사용.
데이터베이스 모델
Prisma 또는 Drizzle 쿼리 결과를 스택 전체에서 공유하는 타입 정의로 변환.
설정 파일
JSON 설정 파일의 타입을 생성하여 컴파일 시 오타와 누락된 필드를 감지.
모의 데이터
모의 JSON 픽스처에서 인터페이스를 생성하여 테스트가 프로덕션 데이터 구조와 동기화 유지.
제한 사항 및 중요 참고 사항
• 혼합 배열의 유니온 타입(예: [1, "hello"])은 `number | string`으로 추론되지만 수동 검토가 필요할 수 있음 • 깊이 중첩된 객체는 많은 하위 인터페이스를 생성 — 실용적인 경우 플래트닝 고려 • JSON Schema 지원은 일반적인 키워드를 커버; 파일 간 $ref 등 고급 기능은 해석되지 않음 • Postman 컬렉션 파싱은 저장된 응답 본문이 포함된 v2.1 형식 필요