# `wscat` を使用した WebSocket API への接続とメッセージの送信
<a name="apigateway-how-to-call-websocket-api-wscat"></a>

この `[wscat](https://www.npmjs.com/package/wscat)` ユーティリティは、API Gateway で作成してデプロイした WebSocket API をテストするための便利なツールです。`wscat` は以下のようにインストールして使用できます。

1. [https://www.npmjs.com/package/wscat](https://www.npmjs.com/package/wscat) から `wscat` をダウンロードします。

1. 次のコマンドを実行して `wscat` をインストールします。

   ```
   npm install -g wscat
   ```

1. API に接続するには、次の例のように `wscat` コマンドを実行します。この例では、`Authorization` 設定が `NONE` であることを前提としています。

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

   `aabbccddee` を実際の API ID に置き換える必要があります。これは API Gateway コンソールに表示されるか、AWS CLI [https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html](https://docs.aws.amazon.com/cli/latest/reference/apigatewayv2/create-api.html) コマンドによって返されます。

   さらに、API が `us-east-1` 以外のリージョンにある場合、正しいリージョンに置き換える必要があります。

1. API をテストするには、接続中に次のようなメッセージを入力します。

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

   ここで、*\$1jsonpath-expression\$1* は JSONPath 式で、*\$1route-key\$1* は API のルートキーです。例:

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

   JSONPath の詳細については、[JSONPath](https://goessner.net/articles/JsonPath/) または [JSONPath for Java](https://github.com/json-path/JsonPath) を参照してください。

1. API から切断するには、「`ctrl-C`」と入力します。