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.

# Configurer une réponse d'intégration d' WebSocket API dans API Gateway
<a name="apigateway-websocket-api-integration-responses"></a>

La section suivante fournit un bref aperçu des réponses d'intégration pour une WebSocket API et explique comment configurer une réponse d'intégration pour une WebSocket API. 

**Topics**
+ [Présentation des réponses d’intégration](#apigateway-websocket-api-integration-response-overview)
+ [Réponses d’intégration pour une communication bidirectionnelle](#apigateway-websocket-api-integration-response-for-two-way-communication)
+ [Configuration d’une réponse d’intégration à l’aide de la console API Gateway](#apigateway-websocket-api-integration-response-using-console)
+ [Configurez une réponse d'intégration à l'aide du AWS CLI](#apigateway-websocket-api-integration-response-using-awscli)

## Présentation des réponses d’intégration
<a name="apigateway-websocket-api-integration-response-overview"></a>

La réponse d’intégration d’API Gateway permet de modéliser et de manipuler la réponse reçue d’un service backend. Il existe certaines différences entre la configuration d'une API REST et une réponse d'intégration d' WebSocket API, mais le comportement est conceptuellement le même.

WebSocket les itinéraires peuvent être configurés pour une communication bidirectionnelle ou unidirectionnelle.
+ Lorsqu'un itinéraire est configuré pour une communication bidirectionnelle, une réponse d'intégration vous permet de configurer des transformations sur la charge utile du message renvoyé, de la même manière que les réponses d'intégration pour REST. APIs
+ Si un itinéraire est configuré pour une communication unidirectionnelle, quelle que soit la configuration de réponse d'intégration, aucune réponse ne sera renvoyée sur le WebSocket canal une fois le message traité.

 API Gateway ne transmet pas la réponse du backend à la réponse de routage, sauf si vous avez configuré une réponse de routage. Pour en savoir plus sur la configuration d’une réponse de routage, consultez [Configuration des réponses d'itinéraire pour WebSocket APIs dans API Gateway](apigateway-websocket-api-route-response.md).

## Réponses d’intégration pour une communication bidirectionnelle
<a name="apigateway-websocket-api-integration-response-for-two-way-communication"></a>

Les intégrations peuvent être divisées en intégrations de *proxy* et *autres que de proxy*.

**Important**  
Pour les *intégrations de proxy*, API Gateway transmet automatiquement la sortie du backend à l’appelant en tant que charge utile complète. Il n’y a pas de réponse d’intégration.

Pour les *intégrations autres que de proxy*, vous devez configurer au moins une réponse d’intégration :
+ Idéalement, une de vos réponses d’intégration doit servir de fourre-tout lorsqu’aucun choix explicite ne peut être effectué. Ce cas par défaut est représenté en définissant une clé de réponse d’intégration `$default`.
+ Dans tous les autres cas, la clé de réponse d’intégration fonctionne en tant qu’expression régulière. Elle doit suivre le format `"/expression/"`.

Pour les intégrations HTTP autres que de proxy :
+ API Gateway tente de mettre en correspondance le code de statut HTTP de la réponse du backend. Dans ce cas, la clé de réponse d’intégration fonctionne en tant qu’expression régulière. Si aucune correspondance n’est trouvée, `$default` est choisi en tant que réponse d’intégration.
+ L’expression de sélection du modèle décrite ci-dessus fonctionne de manière identique. Exemples :
  + `/2\d\d/` : reçoit et transforme les réponses fructueuses
  + `/4\d\d/` : reçoit et transforme les erreurs de demande incorrecte
  + `$default` : reçoit et transforme toutes les réponses inattendues

Pour en savoir plus sur les expressions de sélection de modèle, consultez [Expressions de sélection du modèle](websocket-api-data-transformations.md#apigateway-websocket-api-template-selection-expressions).

## Configuration d’une réponse d’intégration à l’aide de la console API Gateway
<a name="apigateway-websocket-api-integration-response-using-console"></a>

Pour configurer une réponse d'intégration d'itinéraires pour une WebSocket API à l'aide de la console API Gateway :

1. Connectez-vous à la console API Gateway à l'adresse [https://console.aws.amazon.com/apigateway.](https://console.aws.amazon.com/apigateway)

1.  Choisissez votre WebSocket API et votre itinéraire.

1. Choisissez l’onglet **Demande d’intégration**, puis dans la section **Paramètres de la réponse d’intégration**, choisissez **Créer une réponse d’intégration**.

1. Pour **Clé de réponse**, saisissez une valeur qui sera trouvée dans la clé de réponse trouvée dans le message sortant après avoir évalué l’expression de sélection de réponse. Par exemple, vous pouvez entrer **/4\$1d\$1d/** pour recevoir et transformer les erreurs de mauvaise demande ou entrer **\$1default** pour recevoir et transformer toutes les réponses qui correspondent à l’expression de sélection du modèle. 

1. Pour **Expression de sélection du modèle**, entrez une expression de sélection pour évaluer le message sortant.

1. Choisissez **Créer une réponse**.

1. Vous pouvez également définir un modèle de mappage pour configurer les transformations de votre charge utile de message renvoyé. Sélectionnez **Create template (Créer un modèle)**.

1. Saisissez un nom de clé. Si vous choisissez l’expression de sélection de modèle par défaut, saisissez **\$1\$1default**.

1. Pour **Modèle de réponse**, entrez votre modèle de mappage dans l’éditeur de code.

1. Sélectionnez **Create template (Créer un modèle)**.

1. Choisissez **Déployer l’API** pour déployer votre API.

 Utilisez la commande [wscat](https://www.npmjs.com/package/wscat) suivante pour vous connecter à votre API. Pour plus d’informations sur `wscat`, consultez [`wscat`À utiliser pour se connecter à une WebSocket API et y envoyer des messages](apigateway-how-to-call-websocket-api-wscat.md). 

```
wscat -c wss://api-id.execute-api.us-east-2.amazonaws.com/test
```

 Lorsque vous appelez votre route, la charge utile de message renvoyé est renvoyée. 

## Configurez une réponse d'intégration à l'aide du AWS CLI
<a name="apigateway-websocket-api-integration-response-using-awscli"></a>

La [create-integration-response](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-integration-response.html)commande suivante crée une réponse `$default` d'intégration :

```
aws apigatewayv2 create-integration-response \
    --api-id vaz7da96z6 \
    --integration-id a1b2c3 \
    --integration-response-key '$default'
```