·3분 읽기
JSON 포맷터 활용법 5가지 — API 응답 파싱부터 디버깅까지 실전 가이드
JSON 포맷터로 API 응답을 정리하고 디버깅하는 실전 활용 5가지. 한 줄로 압축된 JSON을 1초 만에 보기 좋게 정리하는 도구 비교까지.
{ }
JSON 포맷터 바로 사용하기
JSON을 예쁘게 정렬하고 검증하세요
→
JSON 포맷터가 필요한 진짜 이유
API 응답이 한 줄로 5,000자 이렇게 오면 어디가 어디인지 한눈에 안 들어와요. 들여쓰기가 들어간 순간 트리 구조가 보이고 디버깅 시간이 1/5로 줄어요.
저도 외주 API 연동할 때 JSON 포맷터 안 쓰고 끝까지 가본 적이 있는데, 같은 버그 잡는데 2시간 걸렸어요. 포맷터 한 번 돌리니 5분 만에 잡혔거든요. 오늘은 단순 정리 외에 실전 활용 5가지를 정리해 드릴게요.
활용 1) API 응답 한 줄 → 보기 좋게
Postman·curl로 받은 응답이 한 줄로 길게 나오는 상황이에요.
```bash
curl https://api.example.com/users/1
# {"id":1,"name":"Kim","address":{"city":"Seoul","zip":"06000"}}
```
이걸 그대로 보면 중첩 구조가 안 보여요. JSON 포맷터에 넣으면 들여쓰기 2칸으로 트리가 펼쳐져요.
```json
{
"id": 1,
"name": "Kim",
"address": {
"city": "Seoul",
"zip": "06000"
}
}
```
F12 콘솔이 자동 펼침을 지원하긴 하지만 응답이 큰 경우 포맷터에 복사해서 보는 게 빨라요.
활용 2) 잘못된 JSON 문법 잡기
JSON 파싱 에러는 대부분 사소한 문법 실수예요. 흔한 5가지.
1. 마지막 요소 뒤 쉼표(`{"a":1,}`)
2. 키에 따옴표 빠짐(`{a:1}`)
3. 작은따옴표 사용(`{'a':1}`)
4. 닫는 괄호 빠짐
5. 주석(`//`) 포함
JSON 포맷터는 이 다섯 가지를 즉시 알려줘요. JSONLint·Toolkio JSON 포맷터에 붙여넣으면 '5번째 줄, 13번째 글자에서 오류' 식으로 위치 표시. 눈으로 찾는 것보다 50배 빨라요.
활용 3) 미니파이 — 파일 크기 줄이기
API 요청 본문이나 설정 파일 배포 시 들여쓰기·공백 제거하면 30~50% 용량 줄어요.
예시. 1MB JSON 설정 파일을 미니파이하면 500~700KB. 모바일 앱 번들 같은 곳에서는 큰 차이거든요.
주의. 사람이 직접 편집하는 파일(설정·번역)은 미니파이 금지. 디버깅·재편집이 지옥이에요. 미니파이는 빌드 산출물·API 응답 같은 기계가 읽는 용도에만 사용하세요.
미니파이 후에도 키 이름은 그대로라 데이터 의미 손실은 없어요.
활용 4) JSON 스키마 검증
프로젝트가 커지면 JSON 구조를 정의(스키마)하고 그에 맞는지 검증하는 단계가 필요해요.
예. 결제 API가 `{amount, currency, customer_id}` 형식이어야 하는데 누가 `customer` 필드명을 잘못 보내는 경우. 스키마 검증으로 즉시 잡아요.
JSON Schema(json-schema.org 표준) 사용. Python(jsonschema), JavaScript(ajv) 라이브러리 활용. 단순 포맷팅 외에 데이터 신뢰성까지 보장해요. CI 파이프라인에 넣으면 잘못된 PR 자동 차단 가능.
활용 5) JSON ↔ 다른 포맷 변환
실무에서는 JSON 외에 YAML·CSV·XML 형식과 자주 변환해요.
- **JSON → YAML**: Kubernetes·CI 설정. YAML이 사람 친화적
- **JSON → CSV**: 엑셀로 분석하려는 경우. 중첩은 평탄화 필요
- **JSON → TypeScript interface**: 타입 자동 생성, 개발 시간 단축
- **JSON → SQL INSERT**: DB 마이그레이션
QuickType·json2csv·yq 같은 도구들이 1~2초 안에 변환해줘요. 손으로 옮기다 오타 내는 것보다 100배 안전해요.
JSON 포맷터 도구 비교
온라인 vs 확장 프로그램 vs 데스크톱 비교예요.
- **온라인(JSONLint·JSON Formatter & Validator·Toolkio)**: 가입 없음, 빠름. 민감 데이터는 주의
- **Chrome 확장(JSON Formatter·JSONVue)**: API URL 직접 열면 자동 포맷. 설치 5초
- **VS Code 내장**: `Shift+Alt+F`로 즉시 포맷팅. 코드 작성 중 전환 없이 사용
- **데스크톱(Visual JSON·JSON Viewer Pro)**: 100MB+ 큰 파일 처리. 회사 내부 데이터 전용
민감 데이터(고객 정보·인증 토큰)는 **로컬 도구만 사용**. 온라인 포맷터에 그대로 붙여넣으면 그 서버에 로그가 남을 수 있어요.
Toolkio JSON 포맷터 사용법
1. JSON 데이터 붙여넣기
2. '포맷팅' 클릭 → 들여쓰기 적용
3. '미니파이' 클릭 → 한 줄로 압축
4. 문법 오류 위치 자동 표시
5. 결과 복사·다운로드
모든 처리가 브라우저 안에서 일어나서 외부 서버 전송 없음. 인증 토큰·고객 데이터 같은 민감 JSON도 안심하고 정리할 수 있어요. 더 깊은 디버깅 패턴은 [JSON Lint 5단계 디버깅](/blog/json-lint-debug-5-steps)에서, 개발자용 10가지 활용은 [JSON 포맷터 10가지 패턴](/blog/json-formatter-developer-10-use-cases)에서 이어 보세요.