JSON 스키마 검사기
브라우저에서 실시간으로 JSON 데이터가
JSON 스키마 검사기 소개
JSON 스키마 검사기는 브라우저에서 실시간으로 입력된 JSON 데이터가 지정된 JSON Schema 사양을 준수하는지 확인하는 무료 온라인 도구입니다. API 개발 또는 시스템 연동 시 JSON 데이터 구조가 올바른지 빠르게 테스트할 때 유용합니다.
Draft 4, Draft 7, Draft 2020-12와 같은 최신 스키마 사양을 지원하며 복잡한 객체나 배열 중첩, 필수 속성 누락 등도 즉시 감지합니다. 모든 처리는 로컬에서 수행되므로 민감한 JSON 데이터도 안전하게 검사할 수 있습니다.
JSON 유효성 검사 방법
JSON Schema 입력
왼쪽의 "JSON Schema" 텍스트 영역에 정의된 스키마를 입력하거나 붙여넣습니다.
JSON Data 입력
오른쪽의 "JSON Data" 텍스트 영역에 검사할 대상 JSON 데이터를 입력합니다.
검사 결과 확인
하단 패널에 검사 결과가 즉시 표시됩니다. 실시간 검사가 켜져 있으면 입력과 동시에 오류 위치(경로 및 원인)가 강조 표시됩니다.
JSON 스키마 용어집
- JSON Schema
- JSON 데이터 구조, 허용 가능한 값 유형, 필수 항목 등을 정의하는 어휘(사양)입니다. 데이터 유효성 검사에 필수적입니다.
- AJV
- Another JSON Schema Validator의 약자로, 이 도구에서 내부적으로 사용하는 빠르고 안정적인 JSON 스키마 검사 라이브러리입니다.
- Instance Path
- JSON 데이터 내에서 오류가 발생한 위치를 나타내는 경로입니다. 예를 들어 `/users/0/age`는 배열의 인덱스 또는 속성 계층으로 표시됩니다.
- Draft 2020-12
- JSON Schema 사양 버전 중 하나로 접두사 및 정규 표현식 처리가 개선된 현대적인 사양입니다.
- Validation
- 데이터의 유효성을 검사하는 작업입니다. 예상치 못한 데이터로 인해 시스템이 중단되는 것을 방지하는 방어막 역할을 합니다.
자주 묻는 질문
- Q.민감한 정보가 포함된 JSON을 입력해도 안전한가요?
- 네, 안전합니다. 이 도구는 입력된 JSON 데이터를 모두 브라우저 내에서만 처리합니다. 외부 서버로 전송되지 않으므로 API 키나 개인 정보가 포함되어 있어도 유출될 위험이 없습니다.
- Q.어떤 버전의 JSON Schema를 지원하나요?
- Draft 4, 6, 7, 2019-09 및 2020-12를 지원합니다. 내부적으로 사용하는 AJV 라이브러리를 통해 최신 사양에 맞게 검증할 수 있습니다.
- Q.JSON 포맷 오류와 스키마 유효성 검사 오류의 차이점은 무엇인가요?
- 포맷 오류는 쉼표 누락이나 따옴표를 닫지 않은 것과 같이 JSON 구문 자체가 잘못된 오류입니다. 스키마 유효성 검사 오류는 JSON 구문은 올바르지만 '나이가 숫자가 아님' 또는 '필수 키 누락' 등 지정된 규칙을 위반한 경우 발생하는 오류입니다.
- Q.여러 파일로 분할된 스키마($ref)를 확인할 수 있나요?
- 이 도구는 단일 브라우저 세션에서 실행되므로 외부 URL을 참조하는 `$ref`를 자동으로 확인하는 데는 제한이 있습니다. 모든 정의를 단일 스키마 객체 내의 `$defs`에 통합하여 사용하는 것이 좋습니다.
- Q.실시간 검사 기능을 끄려면 어떻게 해야 하나요?
- 방대한 JSON을 처리할 때는 입력할 때마다 검사가 실행되어 느려질 수 있습니다. 도구 상단의 '실시간 검사' 토글을 끄면 버튼을 클릭할 때만 검사가 실행되는 수동 모드로 전환할 수 있습니다.
활용 사례
API 응답 테스트
프런트엔드를 구현하기 전에 개발 중인 API가 설계 문서에 따라 JSON 구조를 반환하는지 확인합니다.
설정 파일 구문 검사
복잡한 `config.json` 또는 `package.json`이 사양에 맞게 올바르게 작성되었는지 확인합니다.
검증 규칙 생성
애플리케이션에 임베드할 JSON 스키마를 만들 때 샌드박스로 제대로 작동하는지 테스트합니다.
JSON Schema 학습
$ref 및 allOf와 같은 복잡한 스키마 기능을 학습하면서 실제 데이터에 대한 동작을 시도합니다.
기술 세부 정보
이 도구는 Node.js 생태계의 표준이자 초고속 JSON 스키마 검사기인 Ajv (v8)를 클라이언트 측에서 실행합니다. Ajv는 스키마 정의를 한 번 컴파일하고 최적화된 JavaScript 함수를 생성하여 방대한 JSON 데이터도 매우 빠르게 검증합니다. 모든 검증은 브라우저에서 실행되므로 지연 없는 실시간 사용자 경험을 제공합니다.
피드백 보내기
도구를 개선하는 데 도움이 되도록 의견을 알려주세요.
Feedback is temporarily suspended
The server is busy or spam protection is active. Please try again later.