Protocol
网关通信协议。
WebSocket API
连接
javascript
const ws = new WebSocket('ws://gateway.example.com/ws')消息格式
json
{
"type": "message",
"id": "msg-123",
"payload": {...}
}消息类型
| 类型 | 描述 |
|---|---|
message | 发送消息 |
event | 事件推送 |
request | 请求 |
response | 响应 |
error | 错误 |
REST API
端点
| 方法 | 路径 | 描述 |
|---|---|---|
| GET | /api/v1/messages | 获取消息列表 |
| POST | /api/v1/messages | 发送消息 |
| GET | /api/v1/channels | 获取通道列表 |
| POST | /api/v1/channels | 添加通道 |
认证
bash
curl -H "Authorization: Bearer YOUR_TOKEN" \
https://gateway.example.com/api/v1/messages错误码
| 码 | 描述 |
|---|---|
| 400 | 请求错误 |
| 401 | 未授权 |
| 403 | 禁止访问 |
| 404 | 资源不存在 |
| 429 | 请求过多 |
| 500 | 服务器错误 |