Tag API v3

Tag API 概述

• Tag API 是所有tag接口的统称
• Tag API 有多种设置、更新、删除接口，具体的接口如下：
  • 增加单个tag
  • 删除单个tag
  • 增加多个tag
  • 删除多个tag
  • 删除所有tag
  • 更新tag
  • 多个token设置tag
  • 多个token删除tag
  • 批量设置标签
  • 批量删除标签
• 所有推送目标都采用相同的 URL 发起请求，URL：https://openapi.xg.qq.com/v3/device/tag
• 所有请求参数通过 JSON 封装上传给后台，后台通过请求参数区分不同的推送目标 ​

Tag API 调用地址

https://openapi.xg.qq.com/v3/device/tag

Tag API 请求参数

Tag API 实际例子

• 增加单个tag1，对单个token1

  {   
    "operator_type": 1,
    "platform": "android",
    "tag_list": ["tag1"],
    "token_list": ["token1"]
   }
  

• 删除单个tag1，对单个token1

  {   
    "operator_type": 2,
    "platform": "android",
    "tag_list": ["tag1"],
    "token_list": ["token1"]
   }
  

• 增加多个tag1,tag2，对单个token1

  {   
    "operator_type": 3,
    "platform": "android",
    "tag_list": ["tag1","tag2"],
    "token_list": ["token1"]
   }
  

• 删除多个tag1,tag2，对单个token1

  {   
    "operator_type": 4,
    "platform": "android",
    "tag_list": ["tag1","tag2"],
    "token_list": ["token1"]
   }
  

• 删除所有标签，对单个token1

  {   
    "operator_type": 5,
    "platform": "android",
    "tag_list": ["tag1","tag2"],
    "token_list": ["token1"]
   }
  

• 标签覆盖tag1,tag2，对单个token1

  {   
    "operator_type": 6,
    "platform": "android",
    "tag_list": ["tag1","tag2"],
    "token_list": ["token1"]
   }
  

• 为多个token1,token2添加单个tag1

  {   
    "operator_type": 7,
    "platform": "android",
    "tag_list": ["tag1"],
    "token_list": ["token1","token2"]
  }
  

• 多个token1,token2删除单个tag1

  {   
    "operator_type": 8,
    "platform": "android",
    "tag_list": ["tag1"],
    "token_list": ["token1","token2"]
  }
  

• 批量设置标签,为[tag1,token1],[tag2,token2]设置标签

  {   
    "operator_type": 9,
    "platform": "android",
    "tag_token_list":  [["tag1","token1"],["tag2","token2"]]
  
  }
  

• 批量删除标签,为[tag1,token1],[tag2,token2]删除标签

  {   
    "operator_type": 10,
    "platform": "android",
    "tag_token_list":  [["tag1","token1"],["tag2","token2"]]
  }
  

Tag API应答参数

Tag API请求完整示例

标签设置请求消息

POST /v3/device/tag HTTP/1.1
Host: openapi.xg.qq.com
Content-Type: application/json
Authorization: Basic YTViNWYwNzFmZjc3YTplYTUxMmViNzcwNGQ1ZmI1YTZhOTM3Y2FmYTcwZTc3MQ==
Cache-Control: no-cache
Postman-Token: 4b82a159-afdd-4f5c-b459-de978d845d2f
{
  "operator_type": 1,
  "platform": "android",
  "tag_list": ["tag1"],
  "token_list": ["token1"]
}

标签设置应答消息

{
    "seq": 0,
    "ret_code": 0,
}

错误码

开发者使用过程中不可避难会遇到各种问题，这里提供了常见的错误码释义