TypeScript-JSON Schema 변환기란?
이 도구는 TypeScript 인터페이스를 JSON Schema 형식으로 변환합니다. JSON Schema는 JSON 데이터를 주석 달고 검증하기 위한 표준으로, API 문서화, 폼 검증, 설정 파일 검증에 널리 사용됩니다. TypeScript 타입을 변환하면 검증기, API 게이트웨이, 문서 도구에서 사용할 수 있는 스키마를 얻을 수 있습니다.
사용 방법
- 입력 영역에 TypeScript 인터페이스 정의를 붙여넣으세요.
- “JSON Schema로 변환”을 클릭하여 스키마를 생성하세요.
- 출력된 JSON Schema를 복사하여 프로젝트에서 사용하세요.
지원되는 TypeScript 타입
이 도구는 기본 TypeScript 타입을 지원합니다: string, number, boolean, any, 선택적 속성(?), 배열(type[] 또는 Array<type>). 또한 null과 null을 포함한 유니온 타입(예: string | null)도 인식합니다.
자주 묻는 질문
중첩된 인터페이스를 처리할 수 있나요?
이 도구는 한 번에 하나의 인터페이스를 평면 속성 타입으로 파싱합니다. 중첩된 객체의 경우 별도의 인터페이스로 정의하고 스키마를 수동으로 결합하거나, 인터페이스 내에 인라인 객체 타입을 사용하세요.
어떤 JSON Schema 버전이 생성되나요?
출력은 검증기와 도구에서 가장 널리 지원되는 JSON Schema Draft-07(http://json-schema.org/draft-07/schema#)을 따릅니다.