tencent cloud

移动推送

产品动态
公告
产品功能动态
Android SDK 发布动态
iOS SDK 发布动态
macOS SDK 发布动态
产品简介
产品概述
产品优势
应用场景
全球化部署
购买指南
价格总览
购买指引
计费模式
免费试用
欠费说明
快速入门
创建产品和应用
Android 快速接入
iOS 快速接入
创建推送任务
查询推送记录
推送测试方法指引
产品限制说明
操作指南
推送管理
推送高级功能
实践教程
iOS 平台角标功能实践
API 文档
简介
API 概览
调用方式
推送相关接口
标签相关接口
账号相关接口
统计相关接口
用户属性相关接口
服务端错误码
服务端 SDK
API(Java)
SDK 文档
Android 接入指南
iOS 接入指南
客户端集成插件
macOS接入指南
用户及权限
快速入门配置
进阶自定义配置
资源标签
服务协议
服务等级协议
开发者协议
常见问题
iOS 常见问题
Android 常见问题
Flutter 常见问题
其他问题
移动推送政策
移动推送隐私协议
TPNS 数据处理和安全协议
Developer Agreement
联系我们
词汇表

账号绑定与解绑

PDF
聚焦模式
字号
最后更新时间: 2024-01-17 14:26:44

接口说明

请求方式: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"
}
]
}
]
}
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"
}
]
}
]
}
Token 删除所有绑定 Account:
{
"operator_type": 4,
"token_list": [
"token1",
"token2",
"token3"
]
}
Account 删除所有绑定 Token:
{
"operator_type": 5,
"account_list": [
{
"account": "926@126.com"
},
{
"account": "1527000000"
}
]
}

返回示例

Token 删除绑定 Account:
{
"ret_code": 0,
"err_msg": "NO_ERROR",
"result": [
"0"
]
}


帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈