在线状态 API
在线状态模块当前提供批量查询接口,单次最多查询 100 个用户的在线状态。
模块概览
| 项目 | 值 |
|---|---|
| 接口数量 | 1 |
| 幂等接口 | 0 |
| 路径前缀 | /im/v2 |
| 请求方法 | POST(JSON 请求体) |
| 鉴权方式 | App-Key / Nonce / Timestamp / Signature(见 鉴权与签名) |
| 响应信封 | { code, msg?, data?, requestId? } |
接口列表
| 接口 | 方法 | 路径 | 说明 | 幂等 |
|---|---|---|---|---|
| 批量在线状态 | POST | /im/v2/presence/batch | 批量在线状态(<=100)。 | 否 |
接口约定
- 完整请求地址 = 部署域名 +
/im/v2+ 接口路径;所有接口使用POST。 - 请求头必须携带 App-Key / Nonce / Timestamp / Signature;签名规则见鉴权与签名。
- 响应统一为
{ code, msg?, data?, requestId? };code = 0表示成功。 - 列表类接口使用
limit分页,单页上限见限频与限制。