압축된 페이로드가 포함된 API 메서드 호출

압축된 페이로드가 포함된 API 요청을 하려면 클라이언트는 지원되는 콘텐츠 코딩 중 하나를 사용하여 Content-Encoding 헤더를 설정해야 합니다.

API 클라이언트이고 PetStore API 메서드(POST /pets)를 호출하려 한다고 가정해 보십시오. 다음의 JSON 출력을 사용하여 메서드를 호출하지 마십시오.

POST /pets
Host: {petstore-api-id}.execute-api.{region}.amazonaws.com
Content-Length: ...

{
  "type": "dog",
  "price": 249.99
}

그 대신 GZIP 코딩을 사용하여 압축된 동일한 페이로드가 포함된 메서드를 호출할 수 있습니다.

POST /pets
Host: {petstore-api-id}.execute-api.{region}.amazonaws.com
Content-Encoding:gzip
Content-Length: ...

���RPP*�,HU�RPJ�OW��e&���L,�,-y�j

API Gateway는 요청을 수신하면 지정된 콘텐츠 코딩이 지원되는지 확인합니다. 그런 다음 지정된 콘텐츠 코딩으로 페이로드 압축을 해제하려 시도합니다. 압축 해제에 성공하면 통합 엔드포인트에 요청을 발송합니다. 지정된 코딩이 지원되지 않거나 제공된 페이로드가 지정된 코딩으로 압축되지 않은 경우, API Gateway는 415 Unsupported Media Type 오류 응답을 반환합니다. API 및 스테이지가 식별되기 전에 압축 해제의 초기 단계에서 오류가 발생한 경우, 오류가 CloudWatch Logs에 기록되지 않습니다.