2026-05-18 · 1분 읽기
JSON Validator vs OpenAPI Validator
유효한 JSON이 곧 유효한 API contract는 아닙니다.
JSON Validator는 모든 JSON payload의 쉼표, 따옴표, 타입 오류를 잡습니다.
OpenAPI Validator는 문서가 publish 가능한 API 설명(info, paths, version)인지 확인합니다.
이 비교를 읽는 방법
같은 artifact에 JSON 검증을 먼저, 그다음 OpenAPI 검증을 실행하세요.
| 방식 | 데이터 처리 | 일반적인 속도 | 적합한 용도 |
|---|---|---|---|
| JSON Validator | 로컬 JSON 텍스트 | 즉시 | 설정 파일, API 응답, parse되어야 하는 spec 파일 |
| OpenAPI Validator | 로컬 JSON 또는 YAML spec | 즉시 | codegen/gateway/docs 전 서비스 contract |
핵심 요약
- spec repo에서는 CI에서 JSON → OpenAPI 검증을 연결하세요.
- 구조 검사 통과 후 HTTP 수준 테스트를 추가하세요.
자주 묻는 질문
JSON Validator vs OpenAPI Validator에서는 어떻게 선택해야 하나요?
유효한 JSON이 곧 유효한 API contract는 아닙니다.
OpenAPI Validator은 언제 열어야 하나요?
이 비교가 해당 워크플로를 가리키고 다음 단계를 실행할 준비가 되었을 때 OpenAPI Validator을 여세요.
비교할 때 놓치기 쉬운 점은 무엇인가요?
데이터 경계, 입력 형식, 실패 시 확인 경로를 먼저 점검하세요.