# Use `wscat` para se conectar a uma API do WebSocket e enviar mensagens a ela
<a name="apigateway-how-to-call-websocket-api-wscat"></a>

O utilitário `[wscat](https://www.npmjs.com/package/wscat)` é uma ferramenta conveniente para testar uma API WebSocket criada e implantada no API Gateway. Você pode instalar e utilizar `wscat` da seguinte maneira:

1. Faça download de `wscat` em [https://www.npmjs.com/package/wscat](https://www.npmjs.com/package/wscat).

1. Instale o `wscat` executando o seguinte comando.

   ```
   npm install -g wscat
   ```

1. Para se conectar à sua API, execute o comando `wscat` conforme mostrado no exemplo a seguir. Observe que este exemplo pressupõe que a configuração `Authorization` é `NONE`.

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

   É necessário substituir `aabbccddee` pelo ID de API real que é exibido no console do API Gateway ou retornado pelo 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) da AWS CLI.

   Além disso, se a sua API estiver em uma região diferente de `us-east-1`, será necessário substituir a região correta.

1. Enquanto estiver conectado, para testar a API, insira uma mensagem como a seguinte:

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

   em que *\$1jsonpath-expression\$1* é uma expressão JSONPath e *\$1route-key\$1* é uma chave de roteamento para a API. Por exemplo:

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

   Para obter mais informações sobre o JSONPath, consulte [JSONPath](https://goessner.net/articles/JsonPath/) ou [JSONPath para Java](https://github.com/json-path/JsonPath).

1. Para desconectar-se da API, insira `ctrl-C`.