接口说明
请求方式:POST。
服务地址/v3/device/account/batchoperate
接口功能:异步接口。本接口只负责任务下发,当前不支持实时操作。
参数说明
请求参数
参数名 | 类型 | 是否必需 | 参数说明 |
operator_type | Integer | 是 | 操作类型参数,取值范围为[1,5];值对应功能说明如下: 1:Token 追加设置 account(该类型已废弃)。 2:Token 覆盖设置 account。 3:Token 删除绑定的多个 account。 4:Token 删除绑定的所有 account。 5: account 删除绑定的所有 Token。 |
account_list | Array | 否 | 账号标识集合,当 operator_type = 5 时有效,且必填每个元素包含 account,以及 account_type 字段,加上 account_type 就可以设置类型。 示例如下:
|
token_list | Array | 否 | 设备标识集合, operator_type = 4 时有效,且必填 |
token_accounts | Array | 否 | 当 operator_type = 1、2 、3 时有效且必须每次调用最多允许设置20个 Token。每个 Token_account 由1个 Token 和1个 account_list 组成。 具体示例如下:
|
account_type | Integer | 否 | 账号类型,绑定时可选择账号类型,默认类型为account_type:0,取值可参考 账号类型取值表 |
说明
因“Token 追加设置 account”使用率非常低,且容易被开发者误解,从2020年10月26日开始,追加账号接口停止使用。如您此前有使用该接口,该接口功能将变更为“Token 覆盖设置 account”功能。
一个账号类型只能绑定一个账号,绑定多个账号,后面的账号会覆盖前面绑定的账号。
响应参数
参数名 | 类型 | 是否必要 | 参数说明 |
ret_code | Integer | 是 | |
err_msg | String | 是 | 错误信息 |
result | Array | 是 | 每一个 Token 或账号对应的操作状态码["0","1008006"] |
示例说明
请求示例
Token 追加设置 Account(该类型已废弃):
{"operator_type": 1,"token_accounts": [{"token": "token1","account_list": [{"account": "926@126.com"},{"account": "1527000000"}]},{"token": "token2","account_list": [{"account": "926@163.com"},{"account": "1527000001"}]}]}
请求示例
Token 覆盖绑定 Account:
{"operator_type": 2,"token_accounts": [{"token": "token1","account_list": [{"account": "926@126.com"},{"account": "1527000000"}]},{"token": "token2","account_list": [{"account": "926@163.com"},{"account": "1527000001"}]}]}
返回示例
{"ret_code": 0,"err_msg": "NO_ERROR","result": ["0","0"]}
请求示例
Token 删除绑定 Account:
{"operator_type": 3,"token_accounts": [{"token": "token1","account_list": [{"account": "926@126.com"},{"account": "1527000000"}]},{"token": "token2","account_list": [{"account": "926@163.com"},{"account": "1527000001"}]}]}
返回示例
{"ret_code": 0,"err_msg": "NO_ERROR","result": ["0","0"]}
请求示例
Token 删除所有绑定 Account:
{"operator_type": 4,"token_list": ["token1","token2","token3"]}
返回示例
{"ret_code": 0,"err_msg": "NO_ERROR","result": ["0","0","0"]}
请求示例
Account 删除所有绑定 Token:
{"operator_type": 5,"account_list": [{"account": "926@126.com"},{"account": "1527000000"}]}
返回示例
{"ret_code": 0,"err_msg": "NO_ERROR","result": ["0","0"]}