JSON 입력

생성된 스키마

JSON 스키마 생성기란?

JSON 스키마는 JSON 데이터의 구조를 설명합니다: 필수 필드, 타입, 허용 값, 형식. 스키마 생성기는 샘플 JSON에서 스키마를 추론합니다. 예제 데이터를 붙여넣으면 해당 구조를 설명하는 스키마가 생성됩니다. 그런 다음 스키마를 사용하여 다른 JSON을 검증하거나 API를 문서화할 수 있습니다.

이 도구는 브라우저에서 실행됩니다. JSON을 붙여넣으면 JSON 스키마 초안이 생성됩니다. 서버로 아무것도 전송되지 않습니다.

이 도구 사용 방법

샘플 JSON 붙여넣기

설명하려는 구조를 나타내는 JSON을 붙여넣으세요. 필요한 경우 샘플 또는 업로드를 사용하세요. 생성기는 값(string, number, boolean, array, object)에서 타입을 추론합니다.

스키마 검토

오른쪽 패널에 생성된 스키마가 표시됩니다. type, properties, required 및 객체에 대한 중첩 스키마가 포함될 수 있습니다. 필요한 경우 수동으로 편집할 수 있습니다.

복사 또는 다운로드

스키마를 가져오려면 <strong>복사</strong> 또는 <strong>다운로드</strong>를 사용하세요. 스키마에 대해 JSON을 검증하려면 JSON 유효성 검사기 또는 <a href="https://ajv.js.org/" target="_blank" rel="noopener">Ajv</a>와 같은 라이브러리를 사용하세요.

JSON 스키마 예제

샘플 JSON에서 스키마를 생성합니다. 통신 테마 예제:

JSON 입력

입력

생성된 스키마

출력

생성된 스키마를 사용하는 경우

생성된 스키마는 시작점입니다. 샘플 데이터의 구조를 캡처하지만 너무 엄격하거나 너무 느슨할 수 있습니다. required 배열 추가, 타입 조정 또는 허용 값을 위한 enum 추가가 필요할 수 있습니다. JSON 스키마 문서는 전체 어휘를 설명합니다. API 문서화를 위해 OpenAPI와 같은 도구가 JSON 스키마를 참조할 수 있습니다.

자주 묻는 질문

이 스키마로 JSON을 검증할 수 있나요?

이 도구는 스키마만 생성합니다. 검증하려면 JSON 유효성 검사기 또는 코드에서 Ajv와 같은 라이브러리를 사용하세요.

JSON의 형태가 다양한 경우는?

생성기는 제공한 샘플에서 추론합니다. JSON이 여러 형태(예: 선택적 필드)를 가질 수 있다면 스키마는 수동 편집이 필요할 수 있습니다. 변형에는 oneOf 또는 anyOf를 사용하세요.

데이터가 어딘가로 전송되나요?

아니요. 생성은 브라우저에서 실행됩니다.

어떤 JSON 스키마 초안이 사용되나요?

도구는 draft-07 또는 draft-2020-12를 사용할 수 있습니다. 버전을 확인하려면 생성된 스키마에서 $schema를 확인하세요. JSON 스키마 사양에 세부 정보가 있습니다.

API 응답에 사용할 수 있나요?

예. 일반적인 API 응답을 붙여넣으세요. 생성된 스키마가 해당 구조를 설명합니다. 그런 다음 OpenAPI/Swagger 또는 문서화에 사용할 수 있습니다.

JSON 스키마 생성기

JSON 입력

생성된 스키마