阿里云推送服务

标签：随机数   action   help   dev   and   html   客户端   版本号   初始   

移动推送

• 提供从云端到移动终端的优质推送服务，支持Android和iOS平台的通知/消息的推送功能．

推送内容及模式

• 通知：会自动在手机端弹出通知栏，用户可以打开或者清除通知栏。iOS的通知走APNs(苹果官方推送通知服务)，android 走移动推送自己的通道

　　消息：不会自动在通知栏弹出，会在app中提示消息的接收。iOS和android的消息都走移动推送自己的通道

推送方式

• 按设备号推送，在客户端调用getDeviceld获得设备号，再通过控制台/openapi接口推送

名词解释

• AppKey：app在移动推送中的唯一标示。推送SDK初始化和调用openapi推送时需要，从推送控制台APP列表页的应用证书中获取。

• AppSecret：app的秘钥。推送SDK初始化时需要，从推送控制台APP列表页的应用证书中获取。

• accessKeyld和accessKeySecret：阿里云用户使用云产品的openapi接口验权时需要，从阿里云官网控制台获取https://ak-console.aliyun.com/#/accesskey

• responseld：openapi推送请求返回ID（如需排查问题可告诉客户人员该ID）。

• messageld：某一次推送的消息ID。从控制台通知记录/消息记录中可以找到消息ID。

• deviceld：设备在推送的唯一标示。 32位，数字和小写字母组合，通过代码获取：Android：CloudPushService的getDeviceld方法，iOS：CloudPushSDK的getDeviceld方法。

• deviceToken：iOS设备在苹果中心注册时返回的64位设备标识符（iOS设备同时会有deviceld和deviceToken，请不要混淆）。

• account：给设备添加的账号，可以是任意您的业务需要的，一个设备只能添加一个account，account可以添加多个设备。

• alias：给设备添加的别名，可以是任意您的业务需要的，一个设备可以最多添加128个alias，一个alias可以最多添加128个设备。

• tag：给设备添加的标签，可以是任意您的业务需要的，一个appkey最多能绑定1万个tag，一个tag下绑定的设备没有限制。

限制说明

• targetValue如果为集合，按别名或者设备推送，一次最多传递1000个(通过“,”分割)，按账户推送，则最多传递100个;
• 每个App最多创建1万个tag，tag名称要小于等于128个字符(中文算1个)，一个Tag下可以绑定多个设备，设备个数没有限制；

开始配置

• Android配置： 勾选Android，并填入PackageName，包名需要与您的代码中的applicationID保持一致。请务必确保您创建的不同应用具有不同的PackageName(就是创建应用的bundleld)，阿里云移动推送Android SDK以PackageName作为路由依据，不同应用配置相同包名，可能导致消息错误发送，即与目标应用有相同包名的应用接收到推送消息。

查看Appkey&Secret

在产品列表，进入单个产品管理，在APP列表点击查看信息按钮即可查看该应用的Appkey和Secret。

设备绑定

公共请求参数

公共请求参数是指每个接口都需要使用到的请求参数。

示例

https://cloudpush.aliyuncs.com/
?Format=XML
&RegionId=cn-hangzhou
&Version=2016-08-01
&AccessKeyId=testid
&Signature=Pc5WB8gokVn0xfeu%2FZV%2BiNM1dgI%3D
&SignatureMethod=HMAC-SHA1
&SignatureNonce=15215528852396
&SignatureVersion=1.0
&Timestamp=2016-02-25T12:00:00Z
&<接口相关参数>

公共返回参数

用户发送的每次接口调用请求，无论成功与否，系统都会返回一个唯一识别码RequestId给用户。

JSON示例

{
    "RequestId": "4C467B38-3910-447D-87BC-AC049166F216"
    /* 返回结果数据 */
}

请求结构

服务地址

移动推送API的服务接入地址为：cloudpush.aliyuncs.com

请求参数

每个请求都需要指定要执行的操作，即Action参数（例如Push），以及每个操作都需要包含的公共请求参数和指定操作所特有的请求参数。

字符编码

请求及返回结果都使用UTF-8字符集进行编码

阿里云推送服务

标签：随机数   action   help   dev   and   html   客户端   版本号   初始   

原文地址：https://www.cnblogs.com/crazymagic/p/8794900.html