

# Utilice `wscat` para conectarse y enviar mensajes a una API de WebSocket
<a name="apigateway-how-to-call-websocket-api-wscat"></a>

La utilidad `[wscat](https://www.npmjs.com/package/wscat)` es una herramienta muy práctica para probar una API de WebSocket que se ha creado e implementado en API Gateway. Puede instalar y utilizar `wscat` como se indica a continuación:

1. Descargue `wscat` de [https://www.npmjs.com/package/wscat](https://www.npmjs.com/package/wscat).

1. Instale `wscat` ejecutando el siguiente comando:

   ```
   npm install -g wscat
   ```

1. Para conectarse a su API, ejecute el comando `wscat` como se muestra en el siguiente ejemplo. Tenga en cuenta que en este ejemplo se presupone que `Authorization` es `NONE`.

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

   Tiene que sustituir `aabbccddee` por el ID real de la API, que se muestra en la consola de API Gateway o se obtiene mediante el comando [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 la AWS CLI.

   Además, si la API está en una región distinta de `us-east-1`, tendrá que sustituirla por la región correcta.

1. Para probar la API, introduzca un mensaje como el siguiente mientras está conectado:

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

   donde *\$1jsonpath-expression\$1* es un expresión JSONPath y *\$1route-key\$1* es una clave de ruta para la API. Por ejemplo:

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

   Para obtener más información acerca de JSONPath, consulte [JSONPath](https://goessner.net/articles/JsonPath/) o [JSONPath for Java](https://github.com/json-path/JsonPath).

1. Para desconectarse de la API, introduzca `ctrl-C`.