用户注销或 激活状态回调
即时通讯服务支持在用户注销或重新激活完成时,将处理结果同步到您的应用服务器,便于您知晓单个或批量注销与激活用户的处理进度与结果。
- 发起注销后,服务端会在 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 用户注销中