功能說明
用於查詢自有帳號是否已導入即時通信 IM,支持批量查詢。
https://console.tim.qq.com/v4/im_open_login_svc/account_check?sdkappid=88888888&identifier=admin&usersig=xxx&random=99999999&contenttype=json |
應答包體示例
{
"ActionStatus": "OK",
"ErrorCode": 0,
"ErrorInfo": "",
"ResultItem": [
{
"UserID": "UserID_1",
"ResultCode": 0,
"ResultInfo": "",
"AccountStatus": "Imported"
},
{
"UserID": "UserID_2",
"ResultCode": 0,
"ResultInfo": "",
"AccountStatus": "NotImported"
}
]
}
應答包字段說明
字段 | 類型 | 說明 |
---|---|---|
ActionStatus | String | 請求的處理結果,OK 表示處理成功,FAIL 表示失敗 |
ErrorCode | Integer | 錯誤碼,0表示成功,非0表示失敗 |
ErrorInfo | String | 請求處理失敗時的錯誤信息 |
ResultItem | Array | 單個帳號的結果對象數組 |
UserID | String | 請求檢查的帳號的 UserID |
ResultCode | Integer | 單個帳號的檢查結果:0表示成功,非0表示失敗 |
ResultInfo | String | 單個帳號檢查失敗時的錯誤描述信息 |
AccountStatus | String | 單個帳號的導入狀態:Imported 表示已導入,NotImported 表示未導入 |
錯誤碼說明
除非發生網絡錯誤(例如502錯誤),否則該接口的 HTTP 返回碼均爲200。真正的錯誤碼,錯誤信息是通過應答包體中的 ErrorCode、ErrorInfo 來表示的。 公共錯誤碼(60000到79999)請參見 錯誤碼。 本 API 私有錯誤碼如下:
錯誤碼 | 含義說明 |
---|---|
70169 | 服務端內部超時,請稍後重試 |
70202 | 服務端內部超時,請稍後重試 |
70402 | 參數非法,請檢查必填字段是否填充,或者字段的填充是否符合協議要求 |
70403 | 請求失敗,需要 App 管理員權限 |
70500 | 服務器內部錯誤,請稍後重試 |
接口調試工具
通過 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/kick)
- 查詢帳號在線狀態( v4/openim/querystate)