跳到主要内容

用户注销或激活状态回调

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

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

开通服务​

使用用户注销或激活回调功能前，请确认已为当前 App Key 开通相关服务。您可以在需先按控制台内嵌指南嵌入到管理后台的 IM 服务功能配置页面（page_code: im_service_config）中启用并配置该回调服务。

开通服务时，请配置可正常访问的回调接收地址。如果您的网络有 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。

HTTP
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 分钟后会继续发送回调请求。