JSON Merge Patch 도구

JSON Merge Patch 도구 사용 가이드

Merge Patch는 '바꿀 부분만 같은 모양으로 적어 보내는' 방식의 부분 수정 형식으로, 많은 REST API의 PATCH 요청이 이 규칙을 씁니다. 이 도구는 원본 JSON과 패치를 받아 서버가 적용했을 때와 같은 결과를 미리 보여 줍니다.

규칙은 세 가지입니다. 패치에 적은 키는 그 값으로 바뀌고, 값을 null로 적은 키는 지워지며, 패치에 없는 키는 그대로 남습니다. 객체 안의 객체도 같은 규칙으로 한 단계씩 내려가며 합칩니다.

배열은 항목 단위로 합치지 않고 패치의 배열로 통째로 바뀝니다. 태그 하나만 빼려 해도 남길 태그 전체를 적어야 한다는 점을 결과로 바로 확인할 수 있습니다.

사용 방법

1. 1'원본 JSON' 칸에 현재 데이터를 붙여 넣습니다.
2. 2'Merge Patch' 칸에 바꿀 키만 적은 JSON을 넣습니다. 지울 키는 값을 null로 적습니다.
3. 3'실행'을 눌러 적용 결과를 확인하고 복사하거나 .json으로 받습니다.

원본: {"title":"봄 세일","price":12000,"tags":["sale","new"],"seo":{"title":"봄 세일","noindex":true}}
패치: {"price":9900,"tags":["sale"],"seo":{"noindex":null}}

{
  "title": "봄 세일",
  "price": 9900,
  "tags": [
    "sale"
  ],
  "seo": {
    "title": "봄 세일"
  }
}

이럴 때 쓰면 좋아요

• PATCH API를 호출하기 전에 서버에 반영될 최종 데이터를 미리 확인할 때
• 설정 파일 기본값 위에 환경별 덮어쓰기 값을 합친 결과를 볼 때
• API 문서에 부분 수정 요청 예시와 그 결과를 함께 적을 때
• null 삭제 규칙 때문에 값이 사라지는 문제를 재현해 볼 때

문제가 생겼을 때

활용 팁

• 패치 자체가 객체가 아니라 숫자나 배열이면 원본 전체가 그 값으로 바뀝니다. 의도한 것인지 확인하세요.
• 두 버전의 차이를 보고 싶다면 결과를 JSON 데이터 비교기에 원본과 함께 넣으면 바뀐 키가 표시됩니다.

자주 묻는 질문