服务地址/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}
本页内容是否解决了您的问题?