JSON 스키마 생성기
샘플 JSON에서 JSON 스키마를 생성합니다. 생성기는 타입, 필수 속성, 배열 항목 스키마와 date-time, email, uri, uuid 같은 일반적인 문자열 형식을 추론하고, draft 2020-12, 2019-09 또는 draft-07용 스키마를 작성합니다. 이 스키마로 요청을 검증하거나 API를 문서화하거나 양식을 생성할 수 있습니다.
자주 묻는 질문
지원되는 JSON 스키마 초안은 무엇인가요?
OpenAPI 3.1에서 사용하는 최신 버전인 draft 2020-12와 draft 2019-09, 그리고 여러 구형 검증기와 도구에서 여전히 요구하는 draft-07을 지원합니다. 선택한 버전에 따라 $schema URL가 설정됩니다. 생성기가 작성하는 키워드는 세 버전에서 모두 같은 의미입니다.
필수 속성은 어떻게 결정되나요?
객체의 모든 샘플에 나타나는 속성은 required에 포함됩니다. 객체 배열에서 일부 항목에 없는 키는 required에서 제외됩니다. 옵션을 끄면 required 목록 없이 스키마를 작성할 수 있습니다.
어떤 문자열 형식이 감지되나요?
date-time, date, time, email, uri, uuid 및 ipv4입니다. 해당 속성의 모든 샘플 값이 일치하는 경우에만 형식이 추가되므로, 자유 형식 문자열 값이 하나라도 있으면 해당 속성은 일반 문자열로 유지됩니다. 형식 키워드를 원하지 않으면 감지를 끄세요.
스키마에서 정수와 소수를 구분하나요?
예. 샘플이 모두 정수인 속성은 type integer가 됩니다. 샘플 중 하나라도 소수 부분이 있으면 type number가 되며, number는 정수도 허용합니다.
배열은 어떻게 설명되나요?
배열은 type array가 되고, 모든 요소를 함께 사용해 items 스키마를 만듭니다. 배열 안의 객체는 병합되므로 items 스키마에는 모든 요소에 나타나는 키가 포함되며, required에는 모든 요소에 나타나는 키만 포함됩니다.
혼합 타입은 어떻게 처리되나요?
속성에 서로 다른 단순 값이 포함되면, 예를 들어 한 항목은 문자열이고 다른 항목은 null이면 스키마에 type 배열로 표시됩니다. 예: ["string", "null"]. 객체나 배열이 다른 타입과 섞이면 생성기는 각 타입에 하나씩 스키마를 지정한 anyOf를 사용합니다.
additionalProperties나 제한을 추가하나요?
아니요. 샘플만으로는 추가 키가 금지되는지 또는 실제 최솟값과 최댓값이 얼마인지 알 수 없습니다. 따라서 생성기는 additionalProperties, minLength, maximum 및 유사한 키워드를 생략합니다. 데이터에 필요한 경우 직접 추가하세요.
결과로 데이터를 검증할 수 있나요?
예. 스키마와 데이터를 JSON 스키마 검증기에 붙여넣거나 Ajv 같은 라이브러리와 함께 사용하세요. 먼저 스키마를 확인하세요. 스키마는 샘플을 반영하므로, 실제 데이터에서 누락되거나 null일 수 있지만 샘플에는 없는 필드는 약간 수정해야 합니다.
OpenAPI에서 스키마를 사용할 수 있나요?
OpenAPI 3.1은 JSON Schema 2020-12를 직접 사용하므로, $schema 줄을 제거한 뒤 생성된 스키마를 components/schemas 아래에 넣을 수 있습니다. OpenAPI 3.0은 이전 하위 집합을 사용하므로, 이 경우 타입 배열을 nullable로 바꾸세요.
입력 크기는 최대 얼마인가요?
JSON의 최대 1,000,000자까지, 최대 64단계까지 중첩할 수 있습니다. 샘플은 이 요청에만 분석되며 저장되지 않습니다.