API Gateway 中的 WebSocket API 概览

在 API Gateway 中，您可以创建 WebSocket API 作为Amazon服务（如 Lambda 或 DynamoDB）或 HTTP 终端节点的有状态前端。WebSocket API 根据从客户端应用程序收到的消息内容来调用您的后端。

与接收和响应请求的 REST API 不同，WebSocket API 支持客户端应用程序与后端之间的双向通信。后端可以向连接的客户端发送回调消息。

在 WebSocket API 中，传入的 JSON 消息将根据您配置的路由定向到后端集成。（非 JSON 消息将定向到您配置的 $default 路由。）

路由包含一个路由键，这是在评估路由选择表达式时预期的值。routeSelectionExpression 是在 API 级别定义的属性。它指定了预期存在于消息负载中的 JSON 属性。有关路由选择表达式的更多信息，请参阅路由选择表达式。

例如，如果您的 JSON 消息包含一个 action 属性，并且您想要根据此属性执行不同操作，则您的路由选择表达式可能是 ${request.body.action}。您的路由表将通过将 action 属性的值与您在表中定义的自定义路由键值相匹配来指定要执行的操作。

为 WebSocket API 使用路由

可以使用三个预定义路由：$connect、$disconnect 和 $default。此外，您还可以创建自定义路由。

有关 $connect 和 $disconnect 路由的更多信息，请参阅管理连接的用户和客户端应用程序：$connect 和 $disconnect 路由。

有关 $default 路由和自定义路由的更多信息，请参阅在 API Gateway 中调用与 $default 路由和自定义路由的后端集成。

向连接的客户端应用程序发送数据

后端服务可以将数据发送到连接的客户端应用程序。可以通过执行以下操作来发送数据：

WebSocket API 状态代码

API Gateway WebSocket API 对于从服务器到客户端的通信使用以下状态代码，如 WebSocket Close Code Number Registry 中所述：