JSON to TypeScript 변환기

타입 추론 방식

• 기본형: 문자열, 숫자, 불리언은 string, number, boolean이 됩니다.
• 중첩 객체는 PascalCase 이름의 별도 인터페이스가 됩니다. 예를 들어 billing_address는 BillingAddress가 됩니다.
• 객체 배열은 단수형 이름의 항목 타입 하나로 병합됩니다. users는 User[]가 됩니다. 일부 항목에 없는 키는 선택적(key?:)이 됩니다.
• null 값은 그 키에서 본 다른 값과 결합되어 string | null이 됩니다. 항상 null뿐인 키는 unknown 또는 any가 됩니다.
• 혼합 배열은 (number | string)[] 같은 유니온 배열이 됩니다.
• 같은 구조는 한 번만 선언해 재사용하고, 이름이 겹치는 다른 구조에는 숫자 접미사를 붙입니다.
• 유효한 식별자가 아닌 키(예: "first-name", "2fa")는 따옴표로 감쌉니다.

interface와 type의 차이

일반 객체 구조에서는 둘이 거의 같습니다. interface 선언은 확장과 병합이 가능하고 컴파일러 오류가 약간 더 명확합니다. type 별칭은 유니온과 매핑 타입도 표현할 수 있습니다. 많은 팀이 API 모델에는 인터페이스를, 나머지에는 타입을 씁니다. 코드베이스나 린터(@typescript-eslint/consistent-type-definitions)가 요구하는 쪽을 고르세요.

샘플로 더 좋은 타입 얻기

타입은 샘플만큼만 완전할 수 있습니다. 선택적 필드가 포함된 응답이나 다양한 항목이 여러 개 들어 있는 배열을 붙여넣으면 생성기가 선택적 키와 nullable 키를 감지할 수 있습니다. 날짜와 열거형 같은 값은 JSON에서 일반 문자열로 오므로, 생성 후 status: 'active' | 'disabled'처럼 직접 좁혀 주세요. 런타임 검증이 필요하면 생성된 타입을 Zod 같은 스키마 라이브러리와 함께 사용하세요.