응답 포맷 (Response Format)

별칭: response format · 응답 포맷 · API 응답 포맷 · 응답 형식

API가 요청을 받은 뒤 돌려주는 데이터의 구조와 표현 방식.

응답 포맷은 API가 어떤 필드 이름과 중첩 구조로 데이터를 돌려주는지를 뜻한다. 같은 공공데이터라도 JSON, XML, CSV 등 형식이 다를 수 있고, 화면이 기대하는 구조와 다르면 어댑터로 변환해야 한다.

정의

응답 포맷은 API가 요청을 처리한 뒤 돌려주는 데이터의 표현 방식과 구조다. 형식은 JSON, XML, CSV, 텍스트, 파일 등 다양하고, JSON 안에서도 필드 이름·중첩 구조·페이지네이션 방식이 서비스마다 다르다.

왜 중요한가

초보자는 "API 연결"을 URL 호출 하나로 생각하기 쉽지만, 실제로는 응답을 읽어 우리 앱이 이해하는 구조로 맞추는 작업이 대부분이다. 예를 들어 어떤 API는 items 배열을 주고, 다른 API는 response.body.items.item처럼 깊게 감싼 구조를 줄 수 있다.

Semiclass에서의 의미

생활정보 보드는 PublicItem 같은 내부 타입을 기준으로 화면을 만든다. 외부 공공데이터 API 응답이 어떤 모양이든, 신호의 검 단계에서는 그 응답을 title, category, address, source_url 같은 내부 필드로 변환한다. 그래야 화면 컴포넌트가 데이터 출처를 몰라도 동작한다.

주의할 점

응답 포맷은 문서와 실제 응답이 다를 수 있다. 빈 값, 오류 응답, 호출 제한 초과, 날짜·좌표 형식, 한글 인코딩까지 확인해야 한다. AI에게 API 연결을 맡길 때는 실제 응답 예시를 함께 주는 편이 정확하다.

출처