JSON Schema 유효성 검사기

사용 방법

1. 왼쪽에 JSON Schema를, 오른쪽에 JSON 데이터를 붙여넣습니다.
2. 드롭다운에서 스키마 초안(Draft-07 또는 Draft 2020-12)을 선택합니다.
3. Validate 버튼을 클릭합니다 (Ctrl+Enter 단축키 사용 가능).
4. 유효한 경우 데이터가 스키마에 일치한다는 녹색 메시지가 표시됩니다.
5. 유효하지 않은 경우 각 오류의 JSON 경로, 오류 메시지, 추가 파라미터가 나열됩니다.

Load Example을 클릭하면 샘플 User 스키마와 JSON이 자동으로 채워져 바로 사용해볼 수 있습니다.

오류 출력 이해하기

각 유효성 검사 오류에는 세 가지 정보가 포함됩니다:

• 경로 — 실패한 값의 JSON Pointer (예: /items/0/price, 최상위 레벨은 (root)).
• 메시지 — AJV의 쉬운 설명 (예: must be integer, must have required property ‘name’).
• 파라미터 — 허용된 타입, 최솟값, 필요한 패턴 등 추가 컨텍스트.

주요 JSON Schema 키워드

• type — JSON 타입 제한: string, number, integer, boolean, array, object, null.
• required — 객체에 반드시 있어야 하는 속성 이름 배열.
• properties — 객체의 각 명명된 속성에 대한 제약 정의.
• additionalProperties: false — properties에 없는 속성 거부.
• minimum / maximum — 숫자 범위 제약.
• minLength / maxLength — 문자열 길이 제약.
• pattern — 정규식으로 문자열 검증 (예: ”^[a-z]+“).
• enum — 고정된 값 집합으로 제한.
• items — 배열 요소의 스키마 정의.

스키마 예시

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "required": ["name", "age"],
  "properties": {
    "name":  { "type": "string", "minLength": 1 },
    "age":   { "type": "integer", "minimum": 0 },
    "email": { "type": "string" }
  },
  "additionalProperties": false
}

유효한 데이터: {"name":"Alice","age":30}
유효하지 않은 데이터: {"name":"","age":-1,"extra":true} — 세 개의 오류가 발생합니다.