개요

Accept-Post는 특정 리소스가 POST 요청 본문으로 어떤 미디어 타입(들)을 받아들이는지 서버가 알리는 응답 헤더입니다. 클라이언트가 무엇을 POST할 수 있는지 미리 파악하게 해줍니다.

값은 서버가 수용하는 MIME 타입의 목록입니다(예: `Accept-Post: application/json, text/plain, image/webp`).

자세히

요청 측 Accept가 '응답으로 무엇을 받고 싶은가'를 표현한다면, Accept-Post는 응답 측에서 '이 엔드포인트가 POST로 무엇을 받는가'를 알려주는 반대 방향의 협상 정보입니다. 주로 OPTIONS 응답이나 리소스 메타데이터 응답에 실려, 클라이언트가 올바른 Content-Type으로 POST하도록 안내합니다.

PATCH의 짝인 Accept-Patch와 개념이 동일합니다(그쪽은 PATCH가 받는 타입을 알림). 지원 메서드를 알리는 Allow 헤더와 함께 쓰면, 클라이언트는 '이 리소스가 POST를 지원하며, 받는 형식은 이러이러하다'를 한 번에 확인할 수 있습니다.

서버가 지원하지 않는 타입으로 POST가 오면 415 Unsupported Media Type으로 거부하는 것이 일반적인데, Accept-Post는 그런 실패를 사전에 예방하는 힌트 역할을 합니다. 값이 비어 있으면 어떤 타입도 받지 않는다는 의미로 해석될 수 있어 주의가 필요합니다.

문법

Accept-Post: <media-type>[, <media-type>]*

e.g. Accept-Post: application/json, text/plain, image/webp

실무 참고

• Accept(요청, 원하는 응답 타입)와 Accept-Post(응답, 서버가 POST로 받는 타입)는 방향이 반대입니다. 혼동하지 마세요.
• 지원하지 않는 타입으로 POST하면 415 Unsupported Media Type이 반환됩니다. Accept-Post는 이 실패를 예방하는 힌트입니다.
• PATCH에는 Accept-Patch, 지원 메서드에는 Allow가 짝입니다. 함께 노출하면 클라이언트 통합이 쉬워집니다.

관련 헤더

스펙 근거