실무 가이드
배포 전에 두 JSON API 응답을 비교하는 방법
API JSON 응답을 안전하게 비교하고 입력을 정리하며 변경된 키를 찾는 절차입니다.
업데이트 2026-06-03 · 6 분 읽기
텍스트 diff가 헷갈리는 이유
API 응답은 공백, 속성 순서, 포맷만 바뀌는 경우가 많습니다. 데이터 의미가 같아도 텍스트 diff는 큰 변경처럼 보일 수 있습니다.
JSON Diff는 유효한 JSON을 먼저 정리하고 정규화된 구조를 비교하므로 API 변경 검토에 더 적합합니다.
배포 전 점검 절차
프로덕션과 스테이징 응답을 확보하고 비교 전에 토큰, 세션 ID, 개인정보를 제거합니다.
두 JSON을 검증하고 포맷한 뒤 비교합니다. timestamp나 requestId보다 의미가 바뀐 키에 집중합니다.
- 비교 전에 구문을 검증합니다.
- 공백이 결과를 지배하지 않도록 포맷을 통일합니다.
- requestId, timestamp, nonce, 캐시 키, 추적 ID 같은 변동 필드는 무시합니다.
- 예상 밖의 추가, 삭제, 타입 변경을 기록합니다.
무엇을 확인할지
삭제된 필드, 이름이 바뀐 키, 배열 순서 변경, 값 타입 변경을 봅니다. 이런 차이가 클라이언트를 가장 자주 깨뜨립니다.
숫자가 문자열로, null이 객체로, 객체가 배열로 바뀌면 호환성 위험으로 다뤄야 합니다.
FAQ
API 응답은 텍스트 diff와 JSON diff 중 무엇을 써야 하나요?
두 입력이 모두 유효한 JSON이면 JSON Diff를 사용합니다. 구조를 먼저 정리하므로 변경된 키, 배열, 중첩 값을 더 쉽게 볼 수 있습니다.
응답 하나가 유효한 JSON이 아니면 어떻게 하나요?
먼저 JSON Validator로 구문 오류를 고칩니다. 그렇지 않으면 diff는 데이터 변경이 아니라 파싱 실패를 보여줍니다.
비공개 API 데이터를 비교해도 되나요?
일반 MKDiff 워크플로에서는 JSON이 브라우저 안에서 처리됩니다. 그래도 공유 전에는 비밀값과 개인 식별 데이터를 제거해야 합니다.