15. 融云 API 15.16 融云在线状态回调【未执行，需三方/真实联调】

Table of Contents

15.16 融云在线状态回调【未执行，需三方/真实联调】

POST /tieup/api/v1/webhooks/rongcloud/online-status-events
Content-Type: application/json

查询参数：

参数 类型 必填 说明
appKey string 是 融云 AppKey
nonce string 是 融云回调 nonce
timestamp string 是 融云回调时间戳
signature string 是 融云回调签名

请求参数：

参数 类型 必填 说明
userid string 否 融云用户 ID，兼容 userId
status string 否 融云在线状态，项目内会转换为本地 online_status
os string 否 客户端系统
time string 否 事件发生时间

请求体示例：

[
  {
    "userid": "10001",
    "status": "1",
    "os": "iOS",
    "time": "2026-06-17 10:00:00"
  }
]

响应字段：

字段 类型 说明
code integer 响应码，成功为 200
message string 响应提示
data.success_count integer 成功处理数量
data.failed_count integer 处理失败数量
data.duplicate_count integer 幂等重复数量
data.total_count integer 本次回调事件总数

响应示例：

{
  "code": 200,
  "message": "成功",
  "data": {
    "success_count": 1,
    "failed_count": 0,
    "duplicate_count": 0,
    "total_count": 1
  }
}

说明：

  • 验签通过后写入 tieup_im_online_event。
  • 按融云 userId 区分粉丝身份和艺人身份；更新 tieup_im_user_bind.online_status，粉丝身份另外镜像兼容字段 tieup_user.online_status，艺人身份不会覆盖粉丝状态。
  • 按 rong_user_id + session_id 聚合多端会话，任一会话在线即为身份在线；事件时间按毫秒保护，旧事件不会覆盖新状态；未匹配用户时 tieup_im_online_event.handle_status = 3。
  • 服务端按 rong_user_id + session_id + event_time + status 生成 event_hash 幂等键，重复回调不重复落事件；缺少会话和时间时追加原始回调哈希兜底。
  • 测试状态：已完成代码实现、数据库升级脚本和 PHP 语法检查，待融云在线状态回调真实联调。