JSON Schema 검증기

JSON 데이터

1
2
3
4
5
6
7
8
9
10

JSON Schema

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18

검증 결과

JSON 데이터 검증

JSON 데이터와 스키마를 입력해 구조와 제약을 검증하세요

데이터 타입과 구조 검증

필수 프로퍼티 확인

제약 및 format 검증

JSON Schema로 JSON을 검증하는 방법 – 단계별 가이드

API 응답, 설정 파일, payload 샘플을 스키마 계약에 대해 검증하세요. 디버깅, 문서화, 계약 테스트에 유용합니다.

  1. 1단계 – JSON 데이터 붙여넣기

    • JSON 데이터 편집기에 JSON을 붙여넣습니다.
    • JSON이 파일/URL/클립보드에 있다면 가져오기 버튼을 사용하세요.
  2. 2단계 – JSON Schema 붙여넣기

    • JSON Schema 편집기에 스키마를 붙여넣습니다.
    • 핵심 구조에 집중하세요: type, properties, required, items.
  3. 3단계 – 검증 결과 읽기

    • 오른쪽 패널에는 valid 표시와 errors 목록이 표시됩니다.
    • 오류 경로(path)를 사용해 어떤 필드가 일치하지 않는지 정확히 찾으세요.
  4. 4단계 – 데이터 또는 스키마 수정

    • 데이터가 잘못되었다면 payload(필드 누락, 타입 오류)를 수정합니다.
    • 계약이 변경되었다면 스키마를 업데이트하고 다시 검증합니다.
  5. 5단계 – CI에서 엄격한 validator 사용

    • 프로덕션 수준의 검증(draft 지원, $ref, 합성 등)이 필요하다면 CI에서 전체 JSON Schema validator를 실행하세요.
    • 스키마를 버전 관리하고 실제 payload fixture로 테스트하세요.

JSON Schema 기능에 대한 중요한 안내

  • 이 validator는 의도적으로 가볍게 설계되어 핵심 keyword( type, properties, required, items)에 집중합니다.
  • 다음 기능에 의존하는 스키마( $ref, anyOf, oneOf, 또는 allOf )는 전체 validator가 필요할 수 있습니다.
예시: 스키마로 JSON 데이터 검증
// JSON data
{ "id": 1, "name": "Maeve Winters" }

// JSON Schema
{
  "type": "object",
  "properties": {
    "id": { "type": "integer" },
    "name": { "type": "string" },
    "email": { "type": "string" }
  },
  "required": ["id", "name", "email"]
}

// Result
{
  "valid": false,
  "errors": ["root: Missing required property 'email'"]
}

관련 JSON Schema 도구

스키마 생성, mock 생성, 검증 전 JSON 정리를 함께 활용하세요.

자주 묻는 질문

JSON Schema 검증이란 무엇인가요?

JSON Schema 검증은 JSON 문서가 지정된 스키마를 따르는지 확인하는 과정입니다. 데이터 타입, 필수 프로퍼티, 제약 조건, 구조 규칙을 검증합니다.

스키마로 JSON을 어떻게 검증하나요?

입력 에디터에 JSON 데이터를, 설정 패널에 스키마를 입력하세요. 입력하는 즉시 자동으로 검증이 수행됩니다.

어떤 검증 오류가 발생할 수 있나요?

흔한 오류로는 타입 불일치, 필수 프로퍼티 누락, 스키마에서 허용하지 않는 추가 프로퍼티, 문자열 길이 위반, 숫자 범위 위반 등이 있습니다.

사용자 정의 JSON Schema를 사용할 수 있나요?

네. 표준 JSON Schema JSON을 붙여넣을 수 있습니다. 다만 이 validator는 type/properties/required/items 같은 핵심 keyword에 초점을 맞추며, $ref를 해결하거나 고급 합성 keyword를 완전히 평가하지는 않습니다.

JSON Schema 검증기 | JSONSwiss