开发前必读

开发前必读

接入步骤

第一步: 创建应用并获取应用信息

可参考开发者中心使用说明

第二步: 使用应用秘钥信息获取公共参数 token

可参考获取鉴权token 接口

第三步: 使用rest api发送消息

可参考详细文档 了解如何推送

接口文档格式说明

接口地址: /xxx
请求方式: GET/POST/PUT/DELETE
request请求说明
  路径参数 ...
  header参数 ...
  body参数 ...
response响应说明
  成功响应数据格式
    content-type: ...
    http code: ...
    返回值示例 ...
    返回结构说明 ...
    返回参数data说明 ...
请求示例 ...
  • 路径参数: 路径中以$符号开头的参数,如果含有中文需要编码(UrlEncode)后传输

V2的优点

  • 严格按照RestFul风格设计接口,包括url路径的调整,method的区别使用等
  • 入参更合理,减少了结构嵌套,分类更清晰,默认值更合理,开发者使用更聚焦
  • 出参结构更统一,方便开发者做解析
  • 接入更简便,文档结构进行了重新整理
  • 欢迎开发者提出优化意见:docs_support@getui.com

推送流程

相比V1

名词变更解释

名词 V1 V2
接口调用凭据 authtoken token
推送目标用户 condition audience.tag,详见参数说明
消息过期时间 通过is_offlineoffline_expire_time两个参数控制 ttl
定时任务推送时间 pushTime,格式:yyyyMMddHHmm schedule_time ,格式:毫秒时间戳
任务组名 task_name group_name
个推消息类型 msg_type push_message,详见参数说明
厂商消息内容 push_info表示ios消息内容,notify表示android消息内容 push_channel,详见参数说明

V1地址入口

开发者中心 SDK 下载

文档中心搜索