请求方式:POST。
服务地址/v3/device/account/batchoperate
接口服务地址与服务接入点一一对应,请选择与您的应用服务接入点对应的 服务地址。
接口功能:异步接口。本接口只负责任务下发,当前不支持实时操作。
参数名 | 类型 | 是否必需 | 参数说明 |
---|---|---|---|
operator_type | Integer | 是 | 操作类型参数,取值范围为[1,5];值对应功能说明如下: |
platform | String | 是 | 客户端平台类型 |
account_list | Array | 否 | 账号标识集合,当 operator_type = 5 时有效,且必填每个元素包含 account,以及 account_type 字段。 示例如下: [{"account":"926@126.com"},{"account":"1527000000"}] |
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"}]}] |
说明:
因“Token 追加设置 account”使用率非常低,且容易被开发者误解,因此计划10月26日开始,追加账号接口停止使用。如您此前有使用该接口,该接口功能将变更为“Token 覆盖设置 account”功能。
参数名 | 类型 | 参数说明 |
---|---|---|
ret_code | Integer | 返回码 |
err_msg | String | 错误信息 |
result | Array | 每一个 Token 或账号对应的操作状态码["0","1008006"] |
{
"operator_type": 1,
"platform": "android",
"token_accounts": [
{
"token": "token1",
"account_list": [
{
"account": "926@126.com"
},
{
"account": "1527000000"
}
]
},
{
"token": "token2",
"account_list": [
{
"account": "926@163.com"
},
{
"account": "1527000001"
}
]
}
]
}
{
"operator_type": 2,
"platform": "android",
"token_accounts": [
{
"token": "token1",
"account_list": [
{
"account": "926@126.com"
},
{
"account": "1527000000"
}
]
},
{
"token": "token2",
"account_list": [
{
"account": "926@163.com"
},
{
"account": "1527000001"
}
]
}
]
}
{
"operator_type": 3,
"platform": "android",
"token_accounts": [
{
"token": "token1",
"account_list": [
{
"account": "926@126.com"
},
{
"account": "1527000000"
}
]
},
{
"token": "token2",
"account_list": [
{
"account": "926@163.com"
},
{
"account": "1527000001"
}
]
}
]
}
{
"operator_type": 4,
"platform": "android",
"token_list": [
"token1",
"token2",
"token3"
]
}
{
"operator_type": 5,
"platform": "android",
"account_list": [
{
"account": "926@126.com"
},
{
"account": "1527000000"
}
]
}
Token 追加设置 Account:
{
"result": [
"ok",
"ok"
],
"ret_code": 0,
"err_msg": "ok"
}
Was this page helpful?