API 응답 형태

API 응답 형태는 서버가 응답 본문에 보내는 필드 이름, 중첩 구조와 각 값의 표현이다. 예를 들어 같은 가격도 price_won: 12900이나 price: { amount: 12900, currency: 'KRW' }로 표현할 수 있다. OpenAPI 같은 인터페이스 설명은 상태 코드별 응답, JSON 같은 응답 형식인 미디어 타입과 본문 구조 규칙을 기술할 수 있다.

응답 형태는 네트워크 경계의 계약이지 특정 화면이 바로 쓰기 좋은 모양이라는 보장은 아니다. 서버의 정해진 후보 중 하나인 상태 값, 단위와 null 허용 여부를 화면 문구·활성 상태·표시 형식으로 해석하는 단계가 필요할 수 있다. 실제 응답이 선언한 형태와 일치하는지는 별도의 런타임 입력 검증 문제다.