服务器端操作自定义tag接口使用说明
最新资讯 • U-Push
3893
2019-7-12
摘要:
此功能为U-Push Pro版的功能,通过技术同学进行后台开放权限后,开发者可根据以下文档进行配置。

1.增加tag

  在原来tag基础上追加tag

       POST   http://msg.umeng.com/api/tag/add?sign=你的签名  

       {

           "appkey":"xxxxx",//你的appkey

           "timestamp":xxxx,//时间戳

           “device_tokens":"xxxxxxx",//单个device_token

           "tag":"xxxx" //要添加的标签,如果有多个,以英文逗号分隔

}


2.根据token获取tag列表

   POST  http://msg.umeng.com/api/tag/list?sign=你的签名 (不支持批量device_token)

    {

      "appkey":"xxxxxx",

     "timestamp":xxxx,

     "device_tokens":"xxxxx",//只支持一个device_token

   }


3.重置tag,会清除原来的tag

   POST http://msg.umeng.com/api/tag/set?sign=你的签名(不支持批量device_token)

   {

    "appkey":"xxxx",

    "timestamp":xxxx,

    "device_tokens":"xxxxx",//只支持一个device_token

    "tag":"xxxx"

   }


4.删除tag

   POST  http://msg.umeng.com/api/tag/delete?sign=你的签名(不支持批量操作)

   {

    "appkey":"xxxx",

    "timestamp":xxxx,

    "device_tokens":"xxxx",//只支持一个device_token

    "tag":"xxxx"

   }

  5.清除设备tag

  POST  http://msg.umeng.com/api/tag/clear?sign=你的签名(不支持批量device-token)

   {

   "appkey":"xxxx",

   "timestamp":xxxx,

   "device_tokens":"xxxx" //只支持一个device_token

  }

6.根据alias添加tag

 POST http://msg.umeng.com/api/tag/add_by_alias?sign=xx

 {

   "appkey":"xxxx",

   "timestamp":xxxx,

   "alias ":"xxxx" 

  “alias_type”:”xx”,

  “tag”:”xx”

  }

 注意:根据alias查询出的token添加tag时,若有一个不成功则返回失败,后续不执行


7.根据alias删除tag

POST http://msg.umeng.com/api/tag/delete_by_alias?sign=xx

{

"appkey":"xxxx",

   "timestamp":xxxx,

   "alias ":"xxxx" 

  “alias_type”:”xx”,

  “tag”:”xx”

}

注意:根据alias查询出的token删除tag时,若有一个不成功则返回失败,后续不执行


 

上述接口成功返回{"ret":"SUCCESS"}

失败返回 {"ret":"FAIL","data":{"error_msg":"xx","error_code":"xxx"}}


error_code参照api文档错误码列表:点击查看


通过tag发消息参照api文档:点击查看

说明:一般情况下生产环境组播筛选会有一天延迟,如果想测试效果,请在测试模式下进行。