

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.

# Intégrations pour REST APIs dans API Gateway
<a name="how-to-integration-settings"></a>

 Après avoir configuré une méthode d’API, vous devez l’intégrer avec 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 [https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html) et une réponse d’intégration par la ressource [https://docs.aws.amazon.com/apigateway/latest/api/API_IntegrationResponse.html](https://docs.aws.amazon.com/apigateway/latest/api/API_IntegrationResponse.html) d’API Gateway. 

Pour configurer une demande d’intégration, vous créez une ressource [https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html](https://docs.aws.amazon.com/apigateway/latest/api/API_Integration.html) 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 [https://docs.aws.amazon.com/apigateway/latest/api/API_IntegrationResponse.html](https://docs.aws.amazon.com/apigateway/latest/api/API_IntegrationResponse.html) 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.

**Topics**
+ [Configuration d’une demande d’intégration dans API Gateway](api-gateway-integration-settings-integration-request.md)
+ [Configuration d’une réponse d’intégration dans API Gateway](api-gateway-integration-settings-integration-response.md)
+ [Intégrations Lambda pour REST APIs dans API Gateway](set-up-lambda-integrations.md)
+ [Intégrations HTTP pour REST APIs dans API Gateway](setup-http-integrations.md)
+ [Diffusez la réponse d'intégration pour vos intégrations de proxy dans API Gateway](response-transfer-mode.md)
+ [Intégrations privées pour REST APIs dans API Gateway](private-integration.md)
+ [Intégrations fictives pour REST APIs dans API Gateway](how-to-mock-integration.md)