# `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) 명령에서 반환하는 ID로 바꿔야 합니다.

   또한 API가 `us-east-1` 이외의 리전에 있는 경우, 올바른 리전으로 대체해야 합니다.

1. API를 테스트하려면 연결된 상태에서 다음과 같은 메시지를 입력하십시오.

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

   여기에서 {{{jsonpath-expression}}}은 JSONPath 표현식이고 {{{route-key}}}는 API에 대한 라우팅 키입니다. 예:

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

   JSONPath에 대한 자세한 내용은 [JSONPath](https://goessner.net/articles/JsonPath/) 또는 [Java용 JSONPath](https://github.com/json-path/JsonPath)를 참조하십시오.

1. API 연결을 해제하려면 `ctrl-C`를 입력합니다.