API迁移指南
Last updated
Was this helpful?
Last updated
Was this helpful?
本文主要介绍了信鸽免费版本到腾讯云版本的接口迁移说明，包括 V3 和 V2 的推送接口、账号接口和标签接口的差异。
请求参数变动说明
协议字段
字段含义说明
变动说明
openapi.xg.qq.com
域名
请根据购买的集群选择对应的域名地址： 1. 广州集群：api.tpns.tencent.com 2. 中国香港集群：api.tpns.hk.tencent.com 3. 新加坡集群：api.tpns.sgp.tencent.com
对比基本相同。 协议中部分字段格式以及命名有变化，具体差异如下：
免费版本使用 AppId + SecretKey 进行 Basic Auth 鉴权。()
腾讯云版本使用 AccessId + SecretKey 进行 Basic Auth 鉴权。()
腾讯云版本没有对应 AppId 字段， 需要使用对应的应用 id
AccessId和密钥SecretKey进行鉴权。
格式和 基本相同, 主要区别如下:
请求参数变动说明
协议字段
字段含义说明
免费版
腾讯云版
custom_content
Android 推送自定义参数
字段格式： json
字段格式：需要序列化为 json string
custom
iOS 推送自定义参数
字段格式： json
字段格式：需要序列化为 json string
push_id
账号列表推送和设备列表推送时，需要填写的推送任务ID
账号列表推送和设备列表推送时， 第一次推送该值填0，系统会创建 对应的推送任务，并且返回对应的 pushid：123，后续推送push_id填 123(同一个文案）表示使用与123 id 对应的文案进行推送
不再支持该字段对应功能
响应参数变动说明
协议字段
字段含义说明
变动说明
ret_code
操作返回码
字段名变更为 retCode
err_msg
操作响应消息
字段名变更为 errMsg
请求参数变动说明
协议字段
字段含义说明
免费版
腾讯云版
tag_token_list
当进行标签和设备批量绑定/解绑时，提供需要绑定/解绑 的标签设备列表，operator_type =9,10时必填
字段格式：[["tag1","token1"]，["tag2","token2"]]，每个对里面标签在前，token在后， 列表中每个元素为 jsonArray
字段格式：[{"tag":"tag123", "token":"token123"}]，列表中每个原始为 jsonObject
腾讯云版本不再支持V2 协议接口
V2 版本对应的V3 版本接口参考如下：
V2接口
V2接口url
V3 接口
V3 接口url
接口定义说明
全量推送
/v2/push/all_device
推送接口
/v3/push/app
标签推送
/v2/push/tags_device
推送接口
/v3/push/app
账号群推
/v2/push/account_list
推送接口
/v3/push/app
设备单推
/v2/push/single_device
推送接口
/v3/push/app
账号单推
/v2/push/single_account
推送接口
/v3/push/app
超大批量账号推送
/v2/push/account_list_multiple
不支持，可使用号码包推送替代
超大批量设备推送
v2/push/device_list_multiple
不支持，可使用号码包推送替代
批量新增标签
/v2/tags/batch_set
标签绑定接口
/v3/device/tag
批量删除标签
/v2/tags/batch_del
标签绑定接口
/v3/device/tag
和 完全相同，无需特别改动。
和 基本相同，主要区别如下：
和 基本相同，主要区别如下：
腾讯云版本错误码是一套全新的返回码，和免费版本不同。 免费版返回码定义参考： 腾讯云版返回码定义参考：
参考
参考
参考
参考
参考
参考
参考