账号绑定与解绑

最近更新时间:2023-12-25 10:51:11

我的收藏

接口说明

请求方式: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 就可以设置类型。
示例如下:
[{"account":"926@126.com"},
{"account":"1527000000"},
{"account":"2849249569","account_type":9}]
token_list
Array
设备标识集合, operator_type = 4 时有效,且必填
token_accounts
Array
当 operator_type = 1、2 、3 时有效且必须每次调用最多允许设置20个 Token。每个 Token_account 由1个 Token 和1个 account_list 组成。 具体示例如下:
[{"token":"token1","account_list":[{"account":"926@126.com"},
{"account":"1527000000"}],{"token":"token2","account_list":
[{"account":"926@163.com",{"account":"1527000001"}]}]
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"
]
}