Suki/docs/zh/solar-network/developers/routing.md

路由及网关

众所周知，Solar Network 的服务器是一个微服务项目，所以在访问 API 的时候，您需要注意路径的指定。

其构造基本为 <BaseURL>/<ServiceID>/<Path>

例如，你需要访问推送服务 (DysonNetwork.Ring) 的通知 API。

export BASE_URL="https://api.solian.app"
export SERVICE_ID="ring"
export PATH="/notifications"
echo $BASE_URL/$SERVICE_ID$PATH
# https://api.solian.app/ring/notifications

服务分工

目前来说，Solar Network 服务端有四个各司其职的服务。

• Pass 负责身份验证（使用 id 访问）
• Ring 负责推送和通知
• Sphere 负责聊天和帖子以及领域相关的功能
• Develop 负责开发者相关功能
• Drive 负责文件上传

其各服务的服务 ID 即为小写服务名（不包含 DysonNetwork. 前缀）

WebSocket

WebSocket 由推送服务负责，但是不使用 /ring 服务 ID 访问，网关直接处理 /ws 的请求。

WebSocket 的消息都会使用 WebSocketPacket 结构，其结构如下：

{
    "type": "包类型",
    "data": "包数据，可能为任何结构、类型",
    "endpoint": "包需要请求的服务，在服务器传来的包不会携带此项；若客户端需要向服务器发送数据包，需要将此项填写为对应服务的 ID 以帮助网关转发此包",
    "error_message": "服务器回传包的错误信息"
}

在访问 WebSocket 网关的时候，有两种授权方式，一种是通用的 Authorization 头。但是由于浏览器无法给 WebSocket 设置请求头，从而提供另一种兼容性选择，将访问令牌放置于 ?tk= 查询参数中。