JSON 포맷팅과 검증

JSON은 먼저 읽기 쉽게 만드는 것이 중요합니다

API 응답, 웹훅 페이로드, 로그, 설정 파일에서는 JSON을 자주 다룹니다.
하지만 실제로는 한 줄로 압축되어 있거나, 중첩이 깊거나, 이스케이프된 문자열이 섞여 있는 경우가 많습니다.

그 상태로 읽으면 필요한 필드를 놓치거나 배열과 객체의 경계를 잘못 이해하기 쉽습니다.
먼저 JSON을 포맷팅해 구조를 확인하는 것이 디버깅의 시작입니다.

포맷팅 후 확인할 것

중첩 구조

정리된 JSON은 어떤 필드가 어떤 객체에 속하는지 명확하게 보여줍니다.
user.profile.name 같은 경로를 확인하거나 배열 안의 객체 구조를 비교할 때 유용합니다.

값의 타입

"123"은 문자열이고 123은 숫자입니다.
"true"와 true, null과 빈 문자열도 다릅니다.
이 차이를 초기에 확인하면 화면 표시, 검증, 연동 과정의 오류를 줄일 수 있습니다.

문법 오류

불필요한 쉼표, 닫히지 않은 중괄호, 따옴표가 빠진 키는 자주 발생하는 JSON 오류입니다.
포맷터로 파싱이 되는지 확인하면 애플리케이션 코드에 넣기 전에 문제를 분리할 수 있습니다.

실무 활용 예

  • API 응답 확인: 브라우저 Network 탭이나 curl 출력 결과를 붙여 넣고 필드를 확인합니다.
  • 로그 분석: 한 줄짜리 구조화 로그를 읽기 쉽게 정리합니다.
  • 샘플 데이터 정리: 문서, 테스트, 버그 리포트에 사용할 JSON 예시를 정돈합니다.
  • 스키마 준비: 정리된 JSON을 바탕으로 TypeScript 타입, Zod 스키마, OpenAPI 정의를 만듭니다.

DevToolKits에서 JSON 확인하기

JSON 포매터를 사용하면 브라우저에서 바로 JSON을 포맷팅하고 검증할 수 있습니다.
구조를 확인한 뒤에는 관련 도구로 이어갈 수 있습니다.

JSON 포맷팅은 작은 작업이지만, 이후의 디버깅과 설계를 훨씬 편하게 만듭니다.