Intégrations pour les API REST dans API Gateway

Après avoir configuré une méthode d'API, vous devez l'intégrer à un point de terminaison dans le serveur principal. Un point de terminaison principal est également appelé point de terminaison d'intégration et peut être une fonction Lambda, une page Web HTTP ou AWS une action de service.

Comme avec la méthode d'API, l'intégration de l'API possède une demande d'intégration et une réponse d'intégration. Une demande d'intégration encapsule une demande HTTP reçue par le backend. Elle peut ou non être différente de la demande de méthode soumise par le client. Une réponse d'intégration est une réponse HTTP encapsulant la sortie renvoyée par le backend.

La configuration d'une demande d'intégration comprend les opérations suivantes : la configuration de la transmission des demandes de méthode soumises par le client au backend ; la configuration de la transformation des données de la demande, le cas échéant, aux données de la demande d'intégration ; la définition de la fonction Lambda à appeler, la définition du serveur HTTP auquel envoyer la demande entrante, ou de l'action de service AWS à appeler.

La configuration d'une réponse d'intégration (applicable uniquement aux intégrations autres que de proxy) comprend les opérations suivantes : la configuration de la transmission des résultats renvoyés par le backend à une réponse de méthode d'un code de statut donné, la configuration de la transformation des paramètres de réponse d'intégration spécifiés aux paramètres de réponse de méthode préconfigurés, et la configuration du mappage du corps de la réponse d'intégration corps au corps de la réponse de la méthode en fonction des modèles de mappage de corps spécifiés.

Par programmation, une demande d'intégration est encapsulée par la ressource Integration et une réponse d'intégration par la ressource IntegrationResponse d'API Gateway.

Pour configurer une demande d'intégration, vous créez une ressource Integration et vous l'utilisez pour configurer l'URL du point de terminaison de l'intégration. Vous définissez ensuite les autorisations IAM d'accès au backend, et vous spécifiez les mappages pour transformer les données des demandes entrantes avant de les transmettre au backend. Pour configurer une réponse d'intégration pour l'intégration autre que d'un proxy, vous créez une ressource IntegrationResponse et vous l'utilisez pour définir sa réponse de méthode cible. Vous pouvez ensuite configurer le mappage de la sortie du backend à la réponse de la méthode.