Product HTTP API
查阅当前源码注册的全部 41 条业务 HTTP 操作。
Product HTTP 提供基础接入与受信管理接口。完整 OpenAPI 与当前 internal/access/api 注册的 41 条操作一一对应。
OpenAPI：完整合同 · 窄 Profile：基础接入 · 消息发送 · Channel 与 Conversation
仅供受信后端调用
Product HTTP 没有通用业务鉴权。请限制网络可达性，并在 API Gateway、服务网格或业务后端完成认证、授权、限流和审计。
接口目录
用户 Token
POST /user/token：保存设备 Token 元数据。
路由发现
GET /route：获取客户端 TCP 与 WebSocket 入口。
消息同步
POST /channel/messagesync：恢复已提交消息。
消息发送
POST /message/send：提交普通持久消息。
频道
Channel、订阅者与允许/拒绝名单管理。
会话
会话列表、重试、未读、隐藏与激活。
错误响应
HTTP 状态、错误体与重试建议。
基础接入合同
JavaScript Web 黄金路径契约非完整 Beta 子集
- POST /user/token
- GET /route
- POST /channel/messagesync
这些调用只允许出现在受信任的 localhost BFF 中；浏览器不能直接调用 Product HTTP API。
下载 OpenAPI 3.1 子集上方快照只证明三条黄金路径操作的示例范围，不代表完整合同已做端到端验收。客户端实时收发仍通过 SDK 和 Gateway 完成。