왜 API 응답은 한 줄로 뭉쳐서 오나요?
대부분의 API 서버는 응답 크기를 줄이기 위해 JSON을 압축(minify)해서 전송합니다. 들여쓰기나 줄바꿈이 없는 게 네트워크 전송에는 효율적이지만, 사람이 눈으로 읽기에는 매우 불편합니다. 특히 중첩된 객체와 배열이 많은 응답일수록 어디서 어디까지가 하나의 항목인지 구분하기 어려워집니다.
단계별로 따라 해보기
1단계. 브라우저 개발자 도구(F12)를 열고 Network 탭에서 확인하려는 API 요청을 클릭합니다. Response 또는 Preview 탭에서 응답 내용을 전체 선택해 복사합니다.
2단계. JSON 포매터/검증기 페이지를 열고 입력창에 복사한 내용을 붙여넣습니다.
3단계. 정렬(2칸) 또는 정렬(4칸) 버튼을 누르면 들여쓰기가 적용되어 어떤 필드가 어떤 객체에 속하는지 한눈에 보입니다. 배열 안에 배열이 있는 복잡한 구조도 계층이 명확하게 드러납니다.
4단계. 응답에 문법 오류가 있거나(예: 서버가 JSON이 아닌 에러 페이지를 반환한 경우) 파싱이 실패하면 오류 메시지와 대략적인 위치가 표시되므로, 실제로 유효한 JSON을 받은 게 맞는지 바로 확인할 수 있습니다.
실무에서 자주 쓰는 상황
- 새로 붙이는 외부 API의 응답 구조를 처음 파악할 때, 문서보다 실제 응답을 보는 게 더 정확한 경우가 많습니다.
- 버그 리포트에서 "응답이 이상하게 온다"는 제보를 받았을 때, 실제 원본 응답을 정리해서 살펴보면 원인을 빠르게 좁힐 수 있습니다.
- 백엔드 팀과 프론트엔드 팀이 응답 스펙을 논의할 때, 정리된 JSON을 캡처해서 공유하면 커뮤니케이션이 빨라집니다.
- 응답을 문서나 이슈 트래커에 첨부하기 전에 필요없는 공백을 없애 압축된 형태로 만들고 싶을 때도 같은 도구의 압축 기능을 사용할 수 있습니다.
정리
API 응답을 눈으로 읽기 좋게 만드는 것만으로도 디버깅 속도가 크게 달라집니다. JSON 포매터/검증기는 별도 설치 없이 브라우저에서 바로 사용할 수 있고, 붙여넣은 응답 내용은 서버로 전송되지 않으므로 사내 API처럼 민감한 데이터도 안심하고 확인할 수 있습니다.