위키득계정 ↗
기술

JSON Schema

JSON Schema기술
대상 자료
JSON
기술 방식
선언적 구조와 제약
검사 도구
JSON Schema 검증기
주요 활용
자료 검증과 문서화
JSON Schema는 JSON 자료의 구조와 제약 조건을 선언적으로 기술하는 언어다. 스키마에 자료형과 속성 및 허용 조건을 정의하고 검증기가 실제 자료가 그 조건에 맞는지 확인한다.

자료와 규칙의 구분

JSON 문서는 실제 값을 담고 스키마는 그 값이 갖춰야 할 구조를 기술한다. 같은 스키마를 여러 자료에 적용해 자료 교환의 공통 조건으로 사용할 수 있다.

선언과 검증기의 역할

스키마를 작성하는 것만으로 검사 자체가 실행되는 것은 아니다. 명세를 구현한 검증기가 자료를 읽고 정의된 규칙과 비교하는 과정이 필요하다.

교환과 문서화

구조와 자료형 및 제약을 공통으로 표현하면 서로 다른 프로그램이 기대하는 입력을 맞추기 쉽다. 같은 정의는 사람이 읽는 설명과 기계가 처리하는 문서 및 자동 검사의 기반으로 활용할 수 있다.

관련 문서

JSON / OpenAPI 명세 / Apache Avro / GraphQL / 데이터베이스 스키마 / API