핵심 요점
- 01Ajv로 구동됩니다. 가장 널리 사용되는 JavaScript JSON 스키마 검증기 — Node.js, Fastify, 대부분의 JS 도구체인에서 통과합니다.
- 02모든 검증 오류를 한 번에 보고합니다(allErrors 모드), 첫 번째 실패만 아닙니다.
- 03각 오류는 빠른 탐색을 위해 실패한 필드의 JSON 포인터 경로를 포함합니다.
- 04스키마와 데이터 모두 브라우저에서 완전히 실행됩니다 — 아무것도 업로드되지 않습니다.
JSON을 스키마에 대해 검증하는 이유는?
JSON 스키마는 JSON 문서의 모양을 설명하는 표준 방법입니다 — 필수 필드, 허용된 유형, 값 제약, 중첩된 객체 구조. 페이로드가 프로덕션에 도달하기 전에 스키마에 대해 검증하면 유형 불일치, 누락된 필수 필드, 제약 위반을 조기에 포착할 수 있습니다.
가장 일반적인 사용 사례는 API 요청 및 응답 본문 테스트, 구성 파일 검증, OpenAPI 예제 객체 확인, 알려진 구조에 대한 데이터 내보내기 확인입니다. Handytool의 검증기는 Ajv를 사용합니다 — 실제로 Node.js 자체 내에서 사용되는 사실상 JavaScript JSON 스키마 라이브러리 — 따라서 여기의 결과는 백엔드가 볼 내용과 일치합니다.
JSON을 스키마에 대해 검증하는 방법
- 01
JSON 스키마를 붙여넣으세요
왼쪽 패널에 스키마를 붙여넣으세요. Draft 7 또는 2019-09 또는 2020-12 스키마로 유형, 속성, 필수, 항목, anyOf, allOf — Ajv 지원 키워드가 포함될 수 있습니다.
- 02
JSON 데이터를 붙여넣으세요
오른쪽 패널에 검증하려는 데이터 문서를 붙여넣으세요. API 요청 본문, 구성 객체, 내보내기 레코드 또는 OpenAPI 사양의 단일 예제입니다.
- 03
검증을 클릭하세요
Ajv는 allErrors: true로 검증을 실행합니다. 첫 번째 실패에서 멈추지 않고 모든 실패를 수집합니다.
- 04
오류 목록을 검토하세요
각 오류는 실패한 값으로의 JSON 포인터 경로(예: /user/email), 실패한 키워드(유형, 필수, 최소), 인간이 읽을 수 있는 메시지를 보여줍니다. 각각을 수정하고 다시 검증하세요.
개발자가 JSON 스키마로 검증하는 것
- 01REST API 요청 본문 — 보내기 전에 페이로드가 끝점의 예상 모양과 일치하는지 확인합니다.
- 02OpenAPI 사양 예제 객체 — 각 예제를 인라인 스키마 구성요소에 대해 검증합니다.
- 03구성 파일 — 필수 키가 있고 값이 올바른 유형인지 확인하세요.
- 04데이터 파이프라인 레코드 — 데이터 생산자와 소비자 간의 구조적 드리프트를 탐지합니다.
- 05양식 제출 페이로드 — 프론트엔드 검증이 백엔드 스키마 제약과 일치하는지 테스트하세요.
- 06제3자 웹훅 본문 — 문서화된 스키마가 실제 페이로드와 일치하는지 확인하세요.
비공개 검증, 서버 필요 없음
Ajv는 브라우저에서 완전히 실행됩니다. 스키마도 데이터도 서버로 전송되지 않습니다 — 내부 데이터 구조를 설명하는 스키마와 민감한 필드 값을 포함하는 데이터 객체를 안전하게 검증할 수 있습니다.
검증기는 JSON 스키마 드래프트 6, 7, 2019-09, 2020-12를 지원합니다. 실제로 가장 일반적인 드래프트는 Draft 7이며 모든 일상적인 키워드를 포함합니다: 유형, 속성, 필수, 항목, 최소, 최대, 패턴, 열거, anyOf, allOf, oneOf, not, $ref.
JSON 스키마 검증 FAQ
어떤 JSON 스키마 드래프트가 지원됩니까?
Ajv는 드래프트 6, 7, 2019-09, 2020-12를 지원합니다. Draft 7은 기존 코드베이스에서 가장 일반적이며 모든 표준 키워드를 포함합니다.
내 $ref 스키마가 왜 해결되지 않습니까?
외부 $ref URL은 이 브라우저 전용 도구에서 가져오지 않습니다. $defs 및 #/$defs/MyType 같은 로컬 JSON 포인터를 사용하여 참조된 모든 스키마를 인라인하세요.
내 스키마 또는 데이터가 서버에 업로드됩니까?
아니요. Ajv는 브라우저에서 완전히 실행됩니다 — 스키마와 데이터 모두 기기에 유지됩니다.
OpenAPI 3 사양을 검증하는 데 이것을 사용할 수 있습니까?
개별 스키마 구성요소와 예제 객체를 검증할 수 있습니다. 전체 OpenAPI 문서 검증에는 사양 메타 스키마를 이해하는 전용 OpenAPI 검증기가 필요합니다.
첫 번째만이 아닌 여러 오류가 표시되는 이유는?
검증기는 allErrors: true로 구성되어 있습니다. 이렇게 하면 Ajv가 첫 번째에서 멈추지 않고 모든 실패를 수집합니다. 이는 의도적입니다 — 반복 검증 시도를 하는 대신 한 번에 모든 문제를 수정할 수 있습니다.