tencent cloud

功能说明

本接口适用于将 App 用户帐号的登录状态（例如 UserSig）失效。
例如，开发者判断一个用户为恶意帐号后，可以调用本接口将该用户当前的登录状态失效，这样用户使用历史 UserSig 登录即时通信 IM 会失败。

注意：

使用该接口将用户登录状态失效后，用户如果使用重新生成的 UserSig 可以成功登录即时通信 IM，接口支持一次失效一个帐号。

接口调用说明

请求 URL 示例

https://xxxxxx/v4/im_open_login_svc/kick?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json

请求参数说明

下表仅列出调用本接口时涉及修改的参数及其说明，更多参数详情请参考 REST API 简介。

最高调用频率

200次/秒。

请求包示例

{
  "UserID":"test"
}

请求包字段说明

应答包体示例

{
 "ActionStatus":"OK",
 "ErrorInfo":"",
 "ErrorCode":0
}

应答包字段说明

错误码说明

除非发生网络错误（例如502错误），否则该接口的 HTTP 返回码均为200。真正的错误码，错误信息是通过应答包体中的 ErrorCode、ErrorInfo 来表示的。
公共错误码（60000到79999）参见 错误码 文档。
本 API 私有错误码如下：

接口调试工具

通过 REST API 在线调试 工具调试本接口。

参考

• 导入单个帐号（v4/im_open_login_svc/account_import）
• 导入多个帐号（v4/im_open_login_svc/multiaccount_import）
• 删除帐号（v4/im_open_login_svc/account_delete）
• 查询帐号（v4/im_open_login_svc/account_check）
• 查询帐号在线状态（ v4/openim/query_online_status）