JSON 포맷터 사용법: API 응답을 빠르게 정리하고 오류 찾기

JSON은 웹 API, 설정 파일, 로그, 데이터 교환에서 가장 자주 만나는 형식 중 하나입니다. 하지만 응답이 한 줄로 압축되어 있거나 중첩 구조가 깊으면 값을 찾고 문제를 확인하기가 어렵습니다. 이럴 때 Cobin JSON 포맷터를 사용하면 구조를 읽기 좋게 정리하고 문법 오류를 바로 확인할 수 있습니다.

JSON 포맷팅이 필요한 이유

컴퓨터는 공백과 줄바꿈이 없는 JSON도 문제없이 처리합니다. 사람에게는 다릅니다. 들여쓰기가 적용된 JSON은 객체와 배열의 시작·끝, 키와 값의 관계를 빠르게 파악할 수 있습니다.

다음 두 JSON은 데이터가 완전히 같습니다.

{ "service": "Cobin", "free": true, "tools": ["JSON", "UUID"] }

{
  "service": "Cobin",
  "free": true,
  "tools": ["JSON", "UUID"]
}

두 번째 형태는 코드 리뷰, API 디버깅, 문서 작성에서 훨씬 편리합니다. 반대로 네트워크 전송량을 조금이라도 줄이고 싶다면 압축 기능으로 첫 번째 형태를 만들 수 있습니다.

JSON 포맷터 사용하는 순서

1. API 응답이나 JSON 문자열을 입력 영역에 붙여 넣습니다.
2. 공백 2칸, 공백 4칸, 탭 중 원하는 들여쓰기를 선택합니다.
3. 정리 버튼을 누릅니다.
4. 결과를 확인한 뒤 복사 버튼으로 가져갑니다.

문법만 확인하고 싶다면 검사, 공백과 줄바꿈을 제거하려면 압축을 사용하면 됩니다. 입력은 브라우저 안에서 처리되므로 비공개 데이터를 외부 서비스로 전송하는 단계를 줄일 수 있습니다. 그래도 운영 비밀번호나 토큰처럼 매우 민감한 값은 어떤 온라인 도구에도 입력하지 않는 습관이 안전합니다.

자주 발생하는 JSON 문법 오류

키와 문자열에는 큰따옴표가 필요합니다

JSON의 객체 키와 문자열 값은 큰따옴표를 사용해야 합니다. JavaScript 객체처럼 작은따옴표나 따옴표 없는 키를 사용할 수 없습니다.

잘못된 예: {name: 'Cobin'}
올바른 예: {"name": "Cobin"}

마지막 항목 뒤에는 쉼표를 쓰지 않습니다

배열과 객체의 마지막 항목 뒤에 남은 쉼표는 흔한 오류입니다.

{
  "name": "Cobin",
  "free": true
}

괄호의 종류와 개수를 확인합니다

객체는 {}, 배열은 []를 사용합니다. 중첩 구조가 깊을수록 닫는 괄호가 누락되기 쉬운데, 포맷터로 들여쓰기를 적용하면 어느 단계에서 문제가 생겼는지 확인하기 쉬워집니다.

포맷팅과 검증의 차이

포맷팅은 유효한 JSON의 표시 방식을 바꾸는 작업입니다. 검증은 입력이 JSON 문법을 따르는지 확인하는 작업입니다. 유효하지 않은 JSON은 먼저 오류를 고쳐야 포맷팅할 수 있습니다.

작업	데이터 변경	주된 용도
정리	공백과 줄바꿈만 변경	읽기, 리뷰, 디버깅
압축	불필요한 공백 제거	전송, 저장
검사	변경 없음	문법 확인

JSON 안에 Base64 문자열이나 URL 인코딩 값이 들어 있다면 Base64 인코더·디코더와 URL 인코더·디코더를 함께 활용할 수 있습니다.

마무리

JSON 포맷터는 단순해 보이지만 API 디버깅 시간을 크게 줄여 주는 기본 도구입니다. 먼저 문법을 검사하고, 읽기 좋은 형태로 정리한 다음, 필요할 때만 압축하는 흐름을 기억해 두면 됩니다.