클러스터 C1: JSON 생태계
API 요청 전 JSON 검증 방법
전송 전에 JSON 포맷팅, Schema 검증, 성공 예시 diff 를 수행하면 API 디버깅 왕복을 크게 줄일 수 있습니다.
전송 전 검증이 필요한 이유
많은 API 오류는 서버 문제처럼 보이지만 실제 원인은 요청 본문의 누락 필드나 타입 불일치인 경우가 많습니다.
게이트웨이 로그를 보기 전에 로컬에서 구조와 타입을 확인하는 편이 훨씬 빠릅니다.
전송 전에 돌릴 체크 순서
- payload 를 먼저 포맷팅해 구조와 중첩을 읽기 쉽게 만듭니다.
- Schema 나 계약 규칙으로 required, type, enum 을 검사합니다.
- 직전 성공 예시와 diff 를 비교해 필드명과 기본값 차이를 확인합니다.
실무 입력/출력 예시
입력
{"status":"ready","meta":{"retry":"3"}}출력
전송 전 확인: - retry 는 number 여야 함 - payload 에 id 필요