公告
产品功能动态
Android SDK 发布动态
iOS SDK 发布动态
macOS SDK 发布动态
服务地址/v3/device/tag
参数名 | 类型 | 是否必需 | 参数说明 |
operator_type | Integer | 是 | 操作类型：
1 - 增加单个 tag，对单个 token 而言
2 - 删除单个 tag，对单个 token 而言
3 - 增加多个 tag，对单个 token 而言
4 - 删除多个 tag，对单个 token 而言
5 - 删除所有标签，对单个 token 而言
6 - 标签覆盖接口（支持多个标签或自定义类标签覆盖），对单个 token 而言
（此接口要清除历史标签之后，才开始设置新的标签，所以针对单个相同 token 的调用，需要间隔一段时间（建议大于1s），否则可能造成更新失败）
7 - 添加单个 tag，对多个 token 而言
8 - 删除单个 tag，对多个 token 而言
9 - 批量添加标签（每次调用最多允许设置20对，每个对里面标签在前，token 在后）
10 - 批量删除标签（每次调用最多允许设置20对，每个对里面标签在前，token 在后） |
token_list | Array | 否 | 设备列表： operator_type = 1,2,3,4,5,6,7,8时，必填 operator_type = 1,2,3,4,5,6时如果该参数包含多个 token 只会设置第一个 token 格式 eg：["token1","token2"] 列表最大不能超过500个值 token 字符串长度不能超过36 |
tag_list | Array | 否 | 标签列表： operator_type = 1,2,3,4,6,7,8时，必填，operator_type = 5时忽略 operator_type = 1,2,7,8 时，如果该参数包含多个 tag 时，如果只是对单个 tag 操作，则只会设置第一个 tag 格式 eg：["tag1","tag2"] 列表最大不能超过500个值 tag 字符串长度不能超过50 |
tag_token_list | Array | 否 | 标签、设备对应列表： operator_type =9,10时，必填 格式 eg： [{"tag":"tag123", "token":"token123"}] 每个对里面标签在前，token 在后 列表最大不能超过500个值 tag 字符串长度不能超过50 token 字符串长度不能超过36 |
Tag， 每个设备Token最多可绑定100个自定义Tag，如需提高该限制，请与我们 客服联系，每个自定义Tag可绑定的设备 token 数量无限制。字段名 | 类型 | 是否必填 | 注释 |
ret_code | Integer | 是 | 错误码，详细参照错误码对照表 |
err_msg | String | 否 | 请求出错时的错误信息 |
result | String | 否 | 请求正确时： 若有额外数据要返回，则结果封装在该字段的 json 中 若无额外数据，则可能无此字段 |
{"operator_type": 1,"tag_list": ["tag1"],"token_list": ["token1"]}
{"operator_type": 2,"tag_list": ["tag1"],"token_list": ["token1"]}
{"operator_type": 3,"tag_list": ["tag1","tag2"],"token_list": ["token1"]}
{"operator_type": 4,"tag_list": ["tag1","tag2"],"token_list": ["token1"]}
{"operator_type": 5,"tag_list": ["tag1","tag2"],"token_list": ["token1"]}
{"operator_type": 6,"tag_list": ["test:2","level"],"token_list": ["token1"]}
{"operator_type": 6,"tag_list": ["test:2","level:2"],"token_list": ["token1"]}
{"operator_type": 7,"tag_list": ["tag1"],"token_list": ["token1","token2"]}
{"operator_type": 8,"tag_list": ["tag1"],"token_list": ["token1","token2"]}
{"operator_type": 9,"tag_token_list": [{"tag": "tag1","token": "token1"}]}
{"operator_type": 10,"tag_token_list": [{"tag": "tag1","token": "token1"},{"tag": "tag2","token": "token2"},{"tag": "tag3","token": "token3"}]}
POST /v3/device/tag HTTP/1.1Host: api.tpns.tencent.comContent-Type: application/jsonAuthorization: Basic YTViNWYwNzFmZjc3YTplYTUxMmViNzcwNGQ1ZmI1YTZhOTM3Y2FmYTcwZTc3MQ==Cache-Control: no-cachePostman-Token: 4b82a159-afdd-4f5c-b459-de978d845d2f{"operator_type": 1,"tag_list": ["tag1"],"token_list": ["token1"]}
{"seq": 0,"ret_code": 0}
文档反馈