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.
Demande de validation pour REST APIs in API Gateway
Vous pouvez configurer API Gateway pour effectuer la validation de base d'une API demande 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 les CloudWatch journaux. 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
Vue d'ensemble de la validation de base des demandes dans API Gateway
APIGateway 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'autre des conditions suivantes, ou les deux :
-
Les paramètres de demande requis dans la URI 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 est conforme à la demande de JSONschéma
configurée de la méthode.
Pour activer la validation, vous devez spécifier des règles de validation dans un validateur de demandes, ajouter le validateur à la API carte des validateurs de demandes et affecter le validateur à des méthodes individuelles. API
Note
La validation du corps de la demande et les Comportements de transfert direct 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 plus d’informations, consultez Comportements de transfert direct.
