JSON 스키마 생성기
JSON sample에서 관찰한 값 타입과 중첩 구조를 재귀적으로 추론해 시작용 JSON Schema를 생성합니다.
사용 방법
- 대표 JSON sample과 schema draft를 선택하고 실행합니다.
핵심 기능과 처리 범위
전용 runner는 Draft 2020-12 또는 Draft 7을 선택할 수 있고 object·array·integer·number·string·boolean·null을 재귀 처리합니다.
처리 원리
object key는 properties와 required에 넣고 array는 element schema를 비교해 하나면 items, 여러 종류면 anyOf를 생성합니다.
예시
user object와 roles string array가 있는 sample은 nested object와 string-array schema로 변환됩니다.
이럴 때 유용합니다
- API sample에서 검토를 시작할 기본 schema skeleton을 만들 때
사용 전 참고
- format, 최소·최대, pattern, enum, optional field, 의미 제약은 sample 하나만으로 알 수 없어 자동 생성하지 않습니다.
기준 및 참고자료
자주 묻는 질문
모든 key가 required가 되나요?
예. 현재 runner는 sample object에서 관찰한 모든 key를 required에 넣으므로 실제 계약에 맞게 수정해야 합니다.