JSON 스키마 생성기(JSON 샘플로부터)

JSON 스키마는 올바른 JSON이 어떻게 생겼는지, 즉 어떤 키가 있고 타입이 무엇이며 어느 것이 필수인지를 설명해 API, 설정 파일, 폼을 자동으로 검증할 수 있게 합니다. 큰 응답에 대해 손으로 쓰는 일은 지루합니다. 샘플을 하나 이상 붙여 넣으면 드래프트 2020-12, 2019-09, 07, 06, 04용 스키마를 얻습니다. 중첩된 객체와 배열은 재귀적으로 기술되고, 모든 샘플에 있는 키는 필수가 되며, 정수는 integer가 되고, date-time, email, uri, uuid 같은 흔한 문자열 형식을 감지합니다.

사용 방법

1. JSON을 붙여 넣습니다. 샘플 배열, 문서 하나, 또는 한 줄에 문서 하나입니다.
2. 샘플이 어떻게 구성되어 있는지 알려 줍니다.
3. 검증기가 쓰는 드래프트를 고릅니다.
4. 필요하면 제목과 $id를 추가하고, 필수 키, additionalProperties: false, 형식 감지, enum을 선택합니다.
5. 스키마를 복사해 다듬으세요. 샘플로는 알 수 없는 설명, 범위, 패턴을 더할 수 있습니다.

계산식

null → "null" · true/false → "boolean" · 3 → "integer" · 2.5 → "number" · "…" → "string"(+ format) · [ … ] → "array" + items · { … } → "object" + properties

같은 위치에서 본 값은 합쳐집니다. integer와 number는 number가 되고, 가끔 null인 값은 ["string", "null"] 같은 타입 목록을 갖게 되며, 다른 종류와 섞인 객체나 배열은 anyOf가 됩니다. 키는 그 위치의 모든 객체에 있어야만 필수입니다. 형식은 그 위치의 모든 문자열이 일치하고 해당 드래프트가 정의한 경우에만 추가됩니다(date와 time은 draft-07부터, uuid와 duration은 2019-09부터).

예시

사용자 샘플 세 개로 속성 7개의 객체 스키마가 만들어집니다. id(integer), email(string, format email), role(string), joined(string, format date-time. "+09:00" 오프셋도 괜찮음), tags(문자열 배열. 한 샘플은 빈 배열), manager(null, 한 번만 나옴), score(number, 한 번만 나옴)입니다. id, email, role, joined, tags는 모든 샘플에 있으므로 필수이고, manager와 score는 아닙니다.