As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.
Usar a validação de solicitação no API Gateway
Você pode configurar o API Gateway para realizar a validação básica de uma solicitação de API antes de prosseguir com a solicitação de integração. Quando a validação falha, o API Gateway falha imediatamente na solicitação, retorna uma resposta de erro 400 para o chamador e publica os resultados da validação em CloudWatch registros. Isso reduz as chamadas desnecessárias para o backend. O mais importante, isso permite concentrar-se nos esforços de validação específicos para o seu aplicativo. É possível validar um corpo de solicitação verificando se os parâmetros de solicitação necessários são válidos e não nulos especificando um esquema de modelo para uma validação de dados mais complicada.
Tópicos
- Visão geral da validação básica de solicitações no API Gateway
- Noções básicas dos modelos de dados
- Configurar a validação básica de solicitações no API Gateway
- Definições do OpenAPI de um exemplo de API com a validação básica de solicitações
- AWS CloudFormation modelo de uma API de amostra com validação de solicitação básica
Visão geral da validação básica de solicitações no API Gateway
O API Gateway pode realizar a validação básica da solicitação, para que você possa enfocar a validação específica do aplicativo no back-end. Para a validação, o API Gateway verifica uma das seguintes condições ou ambas:
-
Se os parâmetros de solicitação necessários no URI, a string de consulta e os cabeçalhos de uma solicitação de entrada estão incluídos e não estão vazios.
-
Se a carga útil de solicitações aplicável atende à solicitação do esquema JSON
do método.
Para ativar a validação, você deve especificar regras de validação em um validador de solicitação, adicionar o validador ao mapa de validadores de solicitação da API e atribuir o validador a métodos de API individuais.
nota
Solicite a validação do corpo e os Comportamentos de passagem direta de integração são dois tópicos distintos. Quando uma carga útil de solicitação não tem nenhum esquema de modelo correspondente, você pode optar por transmitir ou bloquear a carga útil original. Para ter mais informações, consulte Comportamentos de passagem direta de integração.
