跳转到主要内容
POST
/
route
/
batch
curl -X POST "http://localhost:5001/route/batch?intranet=0" \
  -H "Content-Type: application/json" \
  -d '["user1", "user2", "user3"]'

[
  {
    "uids": ["user1", "user2"],
    "tcp_addr": "127.0.0.1:5100",
    "ws_addr": "ws://127.0.0.1:5200",
    "wss_addr": "wss://127.0.0.1:5300"
  },
  {
    "uids": ["user3"],
    "tcp_addr": "127.0.0.1:5101",
    "ws_addr": "ws://127.0.0.1:5201",
    "wss_addr": "wss://127.0.0.1:5301"
  }
]

​
概述

批量获取多个用户的 IM 连接地址，用于为不同用户分配不同的连接节点。

​
查询参数

​
intranet
integer
default:0
是否返回内网地址
  • 0 - 返回外网地址
  • 1 - 返回内网地址

​
请求体

​
uids
array
required
用户 ID 数组
​
uids[]
string
用户 ID
curl -X POST "http://localhost:5001/route/batch?intranet=0" \
  -H "Content-Type: application/json" \
  -d '["user1", "user2", "user3"]'

[
  {
    "uids": ["user1", "user2"],
    "tcp_addr": "127.0.0.1:5100",
    "ws_addr": "ws://127.0.0.1:5200",
    "wss_addr": "wss://127.0.0.1:5300"
  },
  {
    "uids": ["user3"],
    "tcp_addr": "127.0.0.1:5101",
    "ws_addr": "ws://127.0.0.1:5201",
    "wss_addr": "wss://127.0.0.1:5301"
  }
]

​
响应字段

响应是一个数组，每个元素包含以下字段：
​
uids
array
required
分配到此地址的用户 ID 列表
​
tcp_addr
string
required
TCP 连接地址，格式为 host:port
​
ws_addr
string
required
WebSocket 连接地址，格式为 ws://host:port
​
wss_addr
string
required
WebSocket Secure 连接地址，格式为 wss://host:port

​
状态码

状态码说明
200成功获取批量 IM 连接地址
400请求参数错误
500服务器内部错误