跳到主要内容

用户注销或激活状态回调

即时通讯服务支持在用户注销或重新激活完成时,将处理结果同步到您的应用服务器,便于您知晓单个或批量注销与激活用户的处理进度与结果。

  • 发起注销后,服务端会在 15 分钟内通过回调通知注销结果。
  • 重新激活用户 ID、重复注销、重复激活的情况下,即时通讯服务端会实时发起回调通知。

开通服务

使用用户注销与激活状态回调功能前,请确认已为当前 App Key 开通相关服务。您可以在控制台免费基础功能页面启用并配置该回调服务。

开通服务时,请配置可正常访问的回调接收地址。如果您的网络有 IP 访问限制,请务必配置 IP 白名单,否则无法正常接收服务端回调。

回调方法

请求方法: POST

数据格式application/x-www-form-urlencoded

即时通讯服务端会在 POST 请求 URL 中添加签名参数,您可通过签名验证调用者身份和数据有效性,详细参见 服务端回调签名

回调正文参数

该回调服务的 HTTP 请求正文数据格式为 application/x-www-form-urlencoded,包含以下 HTTP 表单参数:

参数类型说明
userIdString用户 ID
operateIdString操作 ID,为当前操作的唯一标识。与注销用户重新激活用户 ID API 返回结果中的操作 ID 一致。
typeInt操作类型。0:注销用户;1:重新激活用户 ID。
codeString激活/注销用户的服务处理结果码。0 表示成功。其他错误码见下表。
timeLong操作时间
  • code 参数说明(激活/注销用户的服务处理结果码)

    Code描述备注
    24353重复注销调用注销接口,传入已完成注销的用户 ID 时,返回该错误码。
    24354重复激活调用重新激活用户 ID 的接口,传入已激活的用户 ID 时,返回该错误码。
    24356用户注销中调用注销接口,传入正在注销流程中的用户 ID 时,返回该错误码。
    其他未知错误

回调请求示例

以下示例假设您在开通服务页面配置的回调接收地址为 http://example.com/user_actiavtation_status_sync.php

POST /user_actiavtation_status_sync.php?appKey=uwd1c0sxdlx2&signTimestamp=1681202504348&nonce=14314&signature=45beb7cc7307889a8e711219a47b7cf6a5b000e8&appKey=uwd1c0sxdlx2 HTTP/1.1
Host: example.com
Content-Type: application/x-www-form-urlencoded
User-Agent: RongCloud/1.0

userId=uid1&operateId=C70B-B1D6-82E7-5SBO&type=0&code=0&time=1681202504348

响应回调请求

提示
  • 只要有 HTTP 200 OK 成功响应,服务端会认为状态已经同步。
  • 如果应答超时 5 秒,服务端会再尝试推送 2 次,如果仍然失败,将不再同步此条状态。
  • 如短时间内有大面积超时,将暂时停止请求您的服务器,1 分钟后会继续发送回调请求。异常断网情况下的会延迟 5 分钟同步。