# Comportamento de solicitação de método para cargas úteis sem modelos de mapeamento para APIs REST no API Gateway Se a solicitação de método tiver uma carga útil e você não tiver um modelo de mapeamento definido para o cabeçalho `Content-Type`, poderá optar por passar a carga útil da solicitação fornecida pelo cliente por meio da solicitação de integração ao backend sem transformação. O processo é conhecido como passagem direta de integração. O comportamento real de passagem de uma solicitação recebida é determinado por essa configuração. Existem três opções: **Quando nenhum modelo corresponder ao cabeçalho Content-Type da solicitação** Escolha essa opção se desejar que o corpo da solicitação de método passe a solicitação de integração para o back-end sem transformação quando o tipo de conteúdo da solicitação de método não corresponder a nenhum dos tipos de conteúdo associados aos modelos de mapeamento. Ao chamar a API do API Gateway, escolha essa opção definindo `WHEN_NO_MATCH` como o valor da propriedade `passthroughBehavior` na [Integração](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html). **Quando não há modelos definidos (recomendado)** Escolha essa opção se desejar que o corpo da solicitação de método passe a solicitação de integração para o back-end sem transformação quando nenhum modelo de mapeamento estiver definido na solicitação de integração. Se um modelo for definido quando essa opção for selecionada, a solicitação de método de um tipo de conteúdo e carga útil que não corresponda a nenhum modelo de mapeamento definido será rejeitada com uma resposta HTTP 415 Tipo de mídia incompatível. Ao chamar a API do API Gateway, escolha essa opção definindo `WHEN_NO_TEMPLATES` como o valor da propriedade `passthroughBehavior` na [Integração](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html). **Nunca** Escolha essa opção se não desejar que o corpo da solicitação de método passe a solicitação de integração para o back-end sem transformação quando nenhum modelo de mapeamento estiver definido na solicitação de integração. Se um modelo for definido quando essa opção for selecionada, a solicitação de método de um tipo de conteúdo não mapeado será rejeitada com uma resposta HTTP 415 Tipo de mídia sem suporte. Ao chamar a API do API Gateway, escolha essa opção definindo `NEVER` como o valor da propriedade `passthroughBehavior` na [Integração](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html). Os exemplos a seguir mostram os possíveis comportamentos de passagem. Exemplo 1: um modelo de mapeamento é definido na solicitação de integração para o tipo de conteúdo `application/json`. | Content-type | Opção de passagem | Comportamento | | --- | --- | --- | | Nenhum O padrão do API Gateway é `application/json` | WHEN\_NO\_MATCH | A carga da solicitação é transformada usando o modelo. | | Nenhum O padrão do API Gateway é `application/json` | WHEN\_NO\_TEMPLATES | A carga da solicitação é transformada usando o modelo. | | Nenhum O padrão do API Gateway é `application/json` | NEVER | A carga da solicitação é transformada usando o modelo. | | application/json | WHEN\_NO\_MATCH | A carga da solicitação é transformada usando o modelo. | | application/json | WHEN\_NO\_TEMPLATES | A carga da solicitação é transformada usando o modelo. | | application/json | NEVER | A carga da solicitação é transformada usando o modelo. | | application/xml | WHEN\_NO\_MATCH | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | application/xml | WHEN\_NO\_TEMPLATES | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. | | application/xml | NEVER | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. | Exemplo 2: um modelo de mapeamento é definido na solicitação de integração para o tipo de conteúdo `application/xml`. | Content-type | Opção de passagem | Comportamento | | --- | --- | --- | | Nenhum O padrão do API Gateway é `application/json` | WHEN\_NO\_MATCH | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | Nenhum O padrão do API Gateway é `application/json` | WHEN\_NO\_TEMPLATES | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. | | Nenhum O padrão do API Gateway é `application/json` | NEVER | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. | | application/json | WHEN\_NO\_MATCH | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | application/json | WHEN\_NO\_TEMPLATES | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. | | application/json | NEVER | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. | | application/xml | WHEN\_NO\_MATCH | A carga da solicitação é transformada usando o modelo. | | application/xml | WHEN\_NO\_TEMPLATES | A carga da solicitação é transformada usando o modelo. | | application/xml | NEVER | A carga da solicitação é transformada usando o modelo. | Exemplo 3: nenhum modelo de mapeamento está definido na solicitação de integração. | Content-type | Opção de passagem | Comportamento | | --- | --- | --- | | Nenhum O padrão do API Gateway é `application/json` | WHEN\_NO\_MATCH | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | Nenhum O padrão do API Gateway é `application/json` | WHEN\_NO\_TEMPLATES | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | Nenhum O padrão do API Gateway é `application/json` | NEVER | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. | | application/json | WHEN\_NO\_MATCH | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | application/json | WHEN\_NO\_TEMPLATES | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | application/json | NEVER | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. | | application/xml | WHEN\_NO\_MATCH | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | application/xml | WHEN\_NO\_TEMPLATES | A carga da solicitação não é transformada e é enviada ao backend no estado em que se encontra. | | application/xml | NEVER | A solicitação é rejeitada com uma resposta HTTP 415 Unsupported Media Type. |