statusmessage API

statusmessage模块共 2 个接口。

模块概览​

项目值
接口数量2
幂等接口0
路径前缀/im/v2
请求方法POST（JSON 请求体）
鉴权方式App-Key / Nonce / Timestamp / Signature（见 鉴权与签名）
响应信封{ code, msg?, data?, requestId? }

接口列表​

接口方法路径说明幂等
发送单聊状态消息POST/im/v2/statusmessage/private/publish发送单聊状态消息：仅投递当时在线的目标会话，不存储、不计未读、不落离线；离线目标 online=false。服务端下发 WS status 帧。覆盖融云 /statusmessage/private/publish.json。否
发送群聊状态消息POST/im/v2/statusmessage/group/publish发送群聊状态消息：向当时在线的群成员扇出（默认不同步发件人），不存储、不计未读。服务端下发 WS status 帧。覆盖融云 /statusmessage/group/publish.json。否

接口约定​

  • 完整请求地址 = 部署域名 + /im/v2 + 接口路径；所有接口使用 POST。
  • 请求头必须携带 App-Key / Nonce / Timestamp / Signature；签名规则见鉴权与签名。
  • 响应统一为 { code, msg?, data?, requestId? }；code = 0 表示成功。
  • 列表类接口使用 limit 分页，单页上限见限频与限制。

相关说明​