

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.

# `wscat`À utiliser pour se connecter à une WebSocket API et y envoyer des messages
<a name="apigateway-how-to-call-websocket-api-wscat"></a>

Cet `[wscat](https://www.npmjs.com/package/wscat)` utilitaire est un outil pratique pour tester une WebSocket API que vous avez créée et déployée dans API Gateway. Vous pouvez installer et utiliser `wscat` comme suit :

1. Téléchargez `wscat` depuis [https://www.npmjs.com/package/wscat](https://www.npmjs.com/package/wscat).

1. Installez `wscat` en exécutant les commandes suivantes.

   ```
   npm install -g wscat
   ```

1. Pour vous connecter à votre API, exécutez la commande `wscat` comme illustré dans l’exemple suivant. Notez que cet exemple part du principe que le paramètre `Authorization` est défini sur `NONE`.

   ```
   wscat -c wss://aabbccddee.execute-api.us-east-1.amazonaws.com/test/
   ```

   Vous devez remplacer `aabbccddee` par l’ID réel de l’API qui est affiché dans la console API Gateway ou renvoyé par la commande [https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) de l’ AWS CLI .

   En outre, si votre API se trouve dans une région autre que `us-east-1`, vous devez remplacer la région par la région correcte.

1. Pour tester votre API, entrez un message tel que le suivant une fois connecté :

   ```
   {"{jsonpath-expression}":"{route-key}"}
   ```

   où *\$1jsonpath-expression\$1* est une JSONPath expression et *\$1route-key\$1* une clé de route pour l'API. Par exemple :

   ```
   {"action":"action1"}
   {"message":"test response body"}
   ```

   Pour plus d'informations sur JSONPath, voir [JSONPath](https://goessner.net/articles/JsonPath/)ou [JSONPath pour Java](https://github.com/json-path/JsonPath).

1. Pour vous déconnecter de votre API, entrez `ctrl-C`.