OpenAPI 入门

万有无界 Hub 通过 HTTP REST 接口对外开放消息与房间能力。

HTTP 接口

方法	路径	用途
POST	`/api/v1/messages/send`	服务端主动向房间发消息
POST	`/api/v1/messages/syncCommand`	发送隐藏指令
GET	`/api/rooms?tenantId=&userId=`	查询用户房间列表
GET	`/api/messages?roomId=&afterSeq=&limit=`	按 `seq` 增量拉消息
GET	`/api/v1/rooms/{roomId}/messages?beforeSeq=&limit=`	倒序分页拉历史（`limit` 上限 100）

通用响应结构

所有接口共用统一响应：

字段	类型	说明
`code`	int	`0` 表示成功
`message`	string	响应消息
`data`	T	业务数据
`traceId`	string	链路追踪 ID
`timestamp`	long	响应时间（毫秒）

分页结果字段：total / page / pageSize / totalPages / list / hasNext。

第一个请求：发送一条消息

curl -X POST <HUB_BASE_URL>/api/v1/messages/send \
  -H "Content-Type: application/json" \
  -d '{
    "tenantId": "tenant_xxx",
    "roomId": "room_xxx",
    "senderId": "user_xxx",
    "content": "hello"
  }'

发送消息请求字段：

字段	必填	说明
`tenantId`	是	租户 ID
`roomId`	是	房间 ID
`senderId`	是	发送者 ID
`content`	是	消息内容；附件场景为 `[{type,assertId,assertName}]` 序列化字符串
`extra`	否	扩展字段，JSON 字符串
`receiverId`	否	指定接收者；提供后只推送给该用户
`method`	否	推送方法，默认 `message.push`
`accessToken`	否	提供时无需传 `tenantId` / `senderId`，从令牌自动解析
`isStream`	否	是否流式，默认 `false`
`msgType`	否	`1` 普通（默认）/ `2` 隐藏 / `3` 系统
`clientMsgId`	否	客户端 UUID，用于去重
`agentMsgId`	否	Agent 侧消息 ID

HTTP 接口

通用响应结构

第一个请求：发送一条消息

下一步

鉴权方式

MCP 接入

​HTTP 接口

​通用响应结构

​第一个请求：发送一条消息

​下一步

鉴权方式

MCP 接入

HTTP 接口

通用响应结构

第一个请求：发送一条消息

下一步