统一推送通道层接口规范本文档适用于 Push 通道厂商、App 开发者、第三方 Push 服务提供商

文件名称: 统一推送通道层接口规范

所属分类: Android

开发工具:

文件大小: 373kb

下载次数: 0

上传时间: 2019-07-04

提供者: pla***

下载 (373kb)

不能下载？报告错误

详细说明：本文档适用于 Push 通道厂商、App 开发者、第三方 Push 服务提供商。本接口规范建议文档包含以下建议内容： ● 整体技术架构 ● 基础功能清单 ● UPS-Server API 接口规范 ● 终端 UPS 服务接口规范前这一技术文稿是由统一推送联盟()技术标准组攥写项日过程中采用三位编码的原则,格式如下 ,初始版本号为其中,在每一次大版本发布的时候加; 在有技术性变吏的时候加,如增加删减功能模块; 在有编辑性改动的时候加,如格式、段落调整本标准起草单位:中国信息通信研究院、华为技术有限公司、北京小米移动软件有限公司、广东欧珀移动通信有限公司、维沃移动通信有限公司、浙江每日互动网络科技股份有限公司、深圳市和讯华谷信息技术有限公司、珠海市魅族通讯设各冇限公司、阿里巴巴(中国)冇限公司、北京百度网讯科技冇限公司深圳市腾讯计算机系统冇限公司、北京爱奇艺科技有限公司、北京北信源软件股份有限公司、平安科技(深圳)有限公司、圳兆日科技股份冇限公司、北京云中融信网络科技冇限公司、努比亚技术有限公司、联想(北京)有限公司、北京奇虎科技有限公司、展讯通信(上海)有限公司、深圳市金立通信设备有限公司、锤子软件(北京有限公司、深圳市万普拉斯科技有限公司、厦门美图移动科技有限公司、青岛海信移动通信技术妝份有限公司、屮国移动通信集闭终端有限公司、新浪网技术(屮国)有限公司、联通宽带在线有限公司、屮国电信殷份有限公司综合平台开发运营中心、网易(杭州)网络有限公司、小沃科技有限公司、中国移动通信集团公司、北京字节跳动科技有限公司。范围安卓生态圈一直为开发者提供了一个开放的运行环境,用于实现各种创新的想法,然而相应地也产生了相应的性能问题。消息推送是运营的重要一环,为了伉化消息推送成功率,降低电量和流量消耗,改善用户的使用体验,系统级的推送服务显得尤为重要,各大手机厂商也已经提供或者正在研发基于各自系统平台的系统推送服务解决方案。故中国信息通信硏究院泰尔终端实验室联手各大手机厂商和提供搾送服务的互联网厂家成立“统一排送联 ”,通过标准化统一通道层,降低终端功耗、捉升用户体验、支撑开发者生态建设,促进安卓推送服务行业盟健康发展,为终端用户提供更好的手机使用体验,为应用开发者解决消息推送需求。本文档适用于通道厂商、开发者、第三方服务提供商。通道厂商:指提供终端设备,并在终端设备操作系统层内置通道,能够对通道进行管控,在黑屏后能够保持通道的厂商开发者指经有效申请并经过通道厂商第三方服务提供商同意,使用服务,具备民事行为能力的个人、法人或其他组织。以下简称开发者。第三方服务提供崗:与通道厂崗对应,指不提供终端设备,提供集成服务的厂崗本接口规范建议文档包含以下建议内容 ●整体技术架构 ●基础功能清单接口规范 ●终端服务接口规范定义和缩略语定义术诘名称含义推送服务器推送服务器接收并处理从应用开发者发的请求消息,向客户端发送内容。客户端安装终端上的客户端,负责统一与交互的,将消息转给发其他。开发者的所有者,开发者应为具备民事行为能力的个人、法人或其他组织。服务器开发者的服务器,调用推送消息客户端安装在手机上的客户端,与客户端交互,接受消息。提供有客户端集成的,提供接口给有客户端,与客户端交互。通知栏消息通知栏消息是指消息通过发送到客户端时,使用通道厂商默认的消息呈现和点击动作留存用户针对具体在个月内注册的,并且登陆过系统,并且未被明确告知卸载的逻辑用户数(非独立终端数)。活跃用户针对具体在个月内登陆过系统,并且未被明确告知卸载的逻辑用户无效用户针对具体没有对应的逻辑用户或者不再活跃用户列表中的逻辑用户当日活跃用广针对具体在查询当天或者指定具体某日期中登陆过系统的逻辑用户消息接收总数针对具体通过单推和接口或者中的单推和推送请求中包含的逻辑用户数。有效接收消息数针对消息接收总数中去除无效用广的消息数在线下发数在针对某逻辑用户下发时,此用户正有效登陆在系统上,并且消息下发成功的消息总数。离线下发数在针对某逻辑用户下发时,此用户未有效登陆在系统上,并且消息无法在即时下发成功,而后用户在消息有效期内登陆到系统并成功下发该消息的总数。实际下发数在线下发数离线下发数终端接收消息数推送系统服务器成功将消息传递给终端,并且收到终端回执的消息总数。终端展示消息数终端在接收到消息后,成功展示在通知栏的消息总数消息点击数消息展示在通知樘后,被用户最终点击的消息总数。缩咯语概要整体技术架构本标准的技术原则为: 减轻尽可能只定义接∏,将实现隐藏到服务侧 ·屏蔽不同商(包括第三方推送)的底层技术差异基本行为一·致性,保证不同的系统上有相同的基本行为,降低不必要的维护成本技术架构: 端设备 ap1服务器 APP APK 第三产 L1 推送服务器 Ap业务部分 ap2服务器应用层商UPS服务器 UPS SDK 长连接 ap3服务器系统层 UPS推送 Service app3这服务器图统一推送的系统框图图中,厂商服务器通过统一接凵接收的推送请求。并和终端系统中的推送保持唯一长连接提供了标准的,实现服务器之间的交工。标准接口本标准接口分为两个部分接凵连接和主要用于应用进行推送请求的鉴权、提交推送请求接口让业务部分可以通过笫三方接口层来使用在于杋上的推送模块,最终连接到推送服务系统,完成使用推送所需要的基础工作基础功能要求功能清单 ·采用或者形式的接口,建议支持 ,避免大量推送时造成连接数压力,提高推送效率和稳定性支持指定单个或一组列表进行消息推送终端侧服务功能清单提供初始化接凵,传入所需的应用信息(如),实现设备注册,并返回给,用于后续进行消息推送服务可以独立完成通知消息展示可以打廾,关闭和注销推送通道的功能提供查询当前的接口; 相关接口() 基木功能接口接口编号接口描述备注服务端和推送服务端之间的接口集推送鉴权操作接口推送操作接凵推送鉴权用于应用摧送用户身你鉴定,通过后可获得用于后续请求身份校验该具有一定的时效性,以保证安全性。后续请求做为请求参数,如使用协议的可以做为头携带,本文后续接口默认都认为已携带该参数,并推荐使用 ●本接口定义参考标准规范请求参数属性类型是否必传说明是依据规范,本值必须为 client credentials 是用户申请推送业务时生成的 (最长节) 是时间戳(单位,标准,从年月日开始) 是用广申请推送业务时获得对应的秘钥 (最长字节) ●响应数据属性类型说明鉴权结果结果描述当鉴权成功时才会有该字段,权限令牌推送消息时,需要提供的有效期,以秒为单位推送对中单个用户,单独推送消息消息总长度不超过字节 ●请求数据属性类型是否必传说明是多列表建议最大值不超过是通知标题(不超过字节) 是通知内容(不超过字节消息保留时长(单位:秒,最长不超过天) 否点击通知栏时打开的组件点击通知栏时打开的组件的参数()(不超过字节) 为满足安卓的特性,增加通知通道的特性(不超过字节) 是推送消息的来源,品牌名称(英文或拼音)(不超过字节) 是如果消息由第三方代发,消息中要挟带消息原始来源的地址(举例: 为原始推送消息发出方,将消息发送给了由代为发送至厂商,则发出的消息中需要增加的地址。) ●响应数据属性类型说明推送结果结果描述任务编号响应结果说明 ●响应结果描述系统未知成功无效的无效的丿商预留错误移动端接口规范() 基本功能接凵接口编号接口描述备注类名注册服务,为设备申请作为唯操作接口标识获得的回调接口回调接口开启推送操作接口只关闭应用通知,不改变关闭推送操作接口接口回调结果回调接口反注册操作接口反注册的回调接口回调接口获取操作接口获得的回调接口回调接口注册服务参数: 字段说明应用的在设各商开发者网站上创建应用时生成的唯一标识 ●返回: ●无说明: 注册服务,获取设备上应用的 ,作为后续的消息推送目标,结果异步回调返回,建议在启动的时候调用注册服务的回调参数字段类型说明应用的返回给应用的作为后续的消息推送目标返回:

(系统自动生成,下载前可以参看下载内容)