JSON 스키마 검사기

JSON 문서가 JSON 스키마를 만족하는지 검사하고 어디서 틀렸는지 확인하세요.

활용 예시

API 응답 구조 확인하기

API가 약속한 스키마와 실제 응답 샘플을 붙여넣어, 배포 전에 필드·타입·필수 속성이 정말 일치하는지 확인하세요.

설정 파일 오류 디버깅하기

툴이 애매한 오류 메시지와 함께 설정 파일을 거부할 때, 문서화된 스키마와 비교해 정확히 어느 필드가 왜 잘못됐는지 확인하세요.

PR의 데이터 규격 검토하기

공유 JSON 구조를 변경하는 PR을 승인하기 전에, 변경된 스키마와 몇 가지 예시 데이터를 넣어 조용히 깨지는 부분이 없는지 확인하세요.

공개된 스키마로 설정 파일 검증하기

많은 CLI 도구가 설정 파일용 JSON 스키마를 공개합니다. 해당 스키마와 함께 내 설정 파일을 붙여넣으면, 도구를 실행하기 전에 오타나 타입 불일치를 미리 잡아낼 수 있습니다.

작성 중인 스키마의 예외 케이스 테스트하기

새 스키마를 작성하는 중이라면, 필수 필드를 빠뜨리거나 타입을 잘못 넣는 등 일부러 잘못된 문서 몇 개를 넣어 스키마가 실제로 이를 걸러내는지 확인할 수 있습니다.

자주 묻는 질문

어떤 JSON 스키마 드래프트를 지원하나요?

이 도구는 가장 널리 호환되는 JSON Schema Draft-07을 기준으로 검사합니다. Draft 2019-09나 2020-12 등 이후 버전에서만 추가된 키워드('$recursiveRef'나 새로운 배열 형식의 'prefixItems' 등)는 인식되지 않고 무시될 수 있습니다.

스키마나 데이터가 서버로 전송되나요?

아니요. 스키마와 문서 모두 ajv 라이브러리를 사용해 브라우저 안에서만 검사됩니다. 어디로도 업로드되지 않습니다.

'잘못된 스키마'와 검사 실패는 어떻게 다른가요?

'잘못된 스키마'는 JSON Schema 자체가 형식에 맞지 않거나 모순되어 컴파일조차 되지 않았다는 뜻으로, 이 경우 검사 자체가 실행되지 못합니다. 검사 실패는 스키마는 정상적으로 컴파일됐지만 문서가 그 규칙을 만족하지 못했다는 뜻이며, 각 실패 규칙이 데이터의 정확한 위치와 함께 나열됩니다.

'위치 `/user/age`: must be >= 0' 같은 오류는 어떻게 읽나요?

경로는 JSON 문서에서 문제가 발생한 위치를 '/'로 중첩된 키와 배열 인덱스를 구분해 보여줍니다. 콜론 뒤의 메시지는 스키마의 어떤 규칙이 깨졌는지 설명합니다.

$ref로 다른 스키마를 참조할 수 있나요?

붙여넣은 같은 문서 안에서 로컬 JSON 포인터(예: '#/definitions/address')를 사용하는 참조만 가능합니다. 네트워크로 아무것도 가져오지 않기 때문에 외부 파일이나 URL 참조는 해석되지 않습니다.

'additionalProperties: false'는 실제로 무엇을 강제하나요?

이 설정이 있으면 스키마에 명시적으로 나열되지 않은 속성을 가진 객체는 거부됩니다. 'eamil'처럼 필드명을 잘못 적은 오타를 걸러내는 흔한 방법으로, 이 설정이 없으면 이런 오타가 조용히 통과될 수 있습니다.

빈 스키마({})도 유효한가요?

네. 빈 스키마는 아무런 제약도 두지 않으므로, 모든 JSON 문서가 이 스키마를 성공적으로 통과합니다.