用户注销或激活状态回调
即时通讯服务支持在用户注销或重新激活完成时,将处理结果同步到您的应用服务器,便于您知晓单个或批量注销与激活用户的处理进度与结果。
- 发起注销后,服务端会在 15 分钟内通过回调通知注销结果。
- 重新激活用户 ID、重复注销、重复激活的情况下,即时通讯服务端会实时发起回调通知。
开通服务
使用用户注销与激活状态回调功能前,请确认已为当前 App Key 开通相关服务。您可以在控制台免费基础功能页面启用并配置该回调服务。
开通服务时,请配置可正常访问的回调接收地址。如果您的网络有 IP 访问限制,请务必配置 IP 白名单,否则无法正常接收服务端回调。
回调方法
请求方法: POST
数据格式: application/x-www-form-urlencoded
即时通讯服务端会在 POST 请求 URL 中添加签名参数,您可通过签名验证调用者身份和数据有效性,详细参见 服务端回调签名。
回调正文参数
该回调服务的 HTTP 请求正文数据格式为 application/x-www-form-urlencoded
,包含以下 HTTP 表单参数:
参数 | 类型 | 说明 |
---|---|---|
userId | String | 用户 ID |
operateId | String | 操作 ID,为当前操作的唯一标识。与注销用户与重新激活用户 ID API 返回结果中的操作 ID 一致。 |
type | Int | 操作类型。0 :注销用户;1 :重新激活用户 ID。 |
code | String | 激活/注销用户的服务处理结果码。0 表示成功。其他错误码见下表。 |
time | Long | 操作时间 |
-
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 分钟同步。