Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
Vous pouvez configurer API Gateway afin d’exécuter la validation de base d’une demande d’API avant de procéder à la demande d’intégration. Lorsque la validation échoue, API Gateway échoue immédiatement à la demande, renvoie une réponse d'erreur 400 à l'appelant et publie les résultats de la validation dans CloudWatch Logs. Cela permet de réduire les appels non nécessaires au backend. Qui plus est, il vous permet de vous concentrer sur les efforts de validation spécifiques à votre application. Vous pouvez valider un corps de demande en vérifiant que les paramètres de demande obligatoires sont valides et autres que null ou en indiquant un schéma de modèle pour la validation de données plus compliquées.
Rubriques
Présentation de la validation de demande de base dans API Gateway
API Gateway peut effectuer la validation de base des demandes, afin que vous puissiez vous concentrer sur la validation spécifique à l’application dans le backend. Pour la validation, API Gateway vérifie l’une ou l’ensemble des conditions suivantes :
-
Les paramètres de demande obligatoires dans l’URI, la chaîne de requête et les en-têtes d’une demande entrante sont inclus et non vides.
-
La charge utile de demande applicable adhère à la demande de schéma JSON
configurée de la méthode pour un type de contenu donné. Si aucun type de contenu correspondant n’est trouvé, la validation de demande n’est pas effectuée. Pour utiliser le même modèle quel que soit le type de contenu, définissez le type de contenu de votre modèle de données sur $default.
Pour activer la validation, vous indiquez des règles de validation dans un validateur de demande, vous ajoutez le validateur au mappage des validateurs de demande de l’API, puis vous affectez le validateur à des méthodes d’API individuelles.
Note
La validation du corps de la demande et les Comportement des demandes de méthode pour les charges utiles sans modèles de mappage pour REST APIs dans API Gateway sont deux sujets distincts. Quand la charge utile d’une demande n’a pas de schéma de modèle correspondant, vous pouvez choisir de transmettre ou de bloquer la charge utile d’origine. Pour de plus amples informations, veuillez consulter Comportement des demandes de méthode pour les charges utiles sans modèles de mappage pour REST APIs dans API Gateway.
