JSON 스키마 검증기

지원 키워드

핵심: type, enum, const, multipleOf, maximum, minimum, exclusiveMaximum, exclusiveMinimum, maxLength, minLength, pattern, maxItems, minItems, uniqueItems, maxContains, minContains, maxProperties, minProperties, required, dependentRequired.

조합: allOf, anyOf, oneOf, not.

적용자: properties, patternProperties, additionalProperties, items, prefixItems, contains, propertyNames.

조건부: if, then, else, dependentSchemas.

참조: $ref, $defs, $id, $anchor.

형식(활성화 시 검증 포함): date-time, date, time, duration, email, hostname, ipv4, ipv6, uri, uuid, regex.

오류 출력

FAIL  /user/email        format            "not-an-email" is not a valid "email"
FAIL  /user/age          minimum           -3 is less than the minimum 0
FAIL  /orders/0/total    type              "42" is not of type "number"
FAIL  /                  required          missing required property "shippingAddress"

모든 오류에는 경로와 실패한 키워드가 포함되어 편집기에서 빠르게 찾을 수 있습니다.

발목을 잡는 draft 차이

올바른 draft를 설정하세요. draft-04 스키마를 2020-12로 검증하면 id와 다른 미묘한 부분을 잘못 해석합니다.

일반적인 워크플로

• API 계약 테스트: 배포 전에 생성/갱신된 OpenAPI 스키마를 실제 샘플 응답에 대해 실행합니다.
• 설정 강화: 병합 전 CI에서 모든 YAML/JSON 설정을 스키마에 대해 검증합니다.
• 데이터 수집: 기대 형태에 맞지 않는 페이로드를 명확한 오류 메시지와 함께 일찍 거부합니다.

흔한 실수

• format 강제 잊기. 기본적으로 대부분의 검증기는 알 수 없는 형식을 주석 전용으로 취급합니다. 잘못된 이메일과 날짜를 실제로 거부하려면 엄격 형식 검증을 활성화하세요.
• oneOf 남용. oneOf의 두 분기가 겹치면 문서는 실패합니다(정확히 하나만 일치해야 함). anyOf나 디스크리미네이터 패턴을 사용하세요.
• additionalProperties: false로 빡빡한 스키마. 새 선택적 필드 추가가 호환성 깨짐 변경이 됩니다. 진정으로 닫힌 객체를 원하지 않는 한 생략하세요.