API概览

欢迎使用阿里云移动推送服务，用户可以使用本文档的介绍对移动推送服务进行相关操作。

API版本号

OpenAPI 2.0的版本号，即请求参数中Version为：2016-08-01。

API更新历史

更新时间	更新说明	SDK版本
2020-09-02	Push/MassPush增加参数AndroidNotificationHuaweiChannel	3.13.5
2020-09-02	新增QueryDeviceCount接口	3.13.4
2020-06-11	Push/MassPush增加参数AndroidNotificationVivoChannel	3.13.3
2020-05-29	Push/MassPush增加参数AndroidNotificationXiaomiChannel	3.13.2
2019-10-25	稳定性提升	3.13.0
2019-10-14	新增持续推送接口: ContinuouslyPush	3.12.0
2019-10-08	新增批量推送接口: MassPush	3.11.0
2018-03-24	增加通过Alias或者Account查询设备列表的接口	3.10.0
2018-02-27	推送接口支持NotificationChannel参数	3.9.0
2017-07-19	高级接口推送消息时支持辅助弹窗	3.4.0
2017-07-07	对Alias操作支持批量操作	3.3.0
2017-06-15	高级接口增加辅助弹窗参数	3.2.0
2017-03-01	新增批量接口: CheckDevices	3.1.0
2016-12-20	高级接口增加静默通知功能	3.0.2
2016-12-06	OpenApi 2.0发布	3.0.0

可以在阿里云 OpenApi Explorer 上实际体验调用下述接口。

推送相关

API	说明
PushMessageToAndroid	推消息给Android设备
PushMessageToiOS	推消息给iOS设备
PushNoticeToAndroid	推通知给Android设备
PushNoticeToiOS	推通知给iOS设备
Push	推送高级接口（通知/消息均可发送）
MassPush	批量推送接口
ContinuouslyPush	持续推送接口
CancelPush	取消定时推送任务

设备绑定

API	说明
QueryAliases	查询别名
BindAlias	绑定别名
UnbindAlias	解绑别名
QueryDevicesByAlias	通过别名查询设备
QueryTags	查询TAG
BindTag	绑定TAG
UnbindTag	解绑TAG
RemoveTag	删除TAG
QueryDevicesByAccount	通过账户查询设备

查询与统计

API	说明
QueryUniqueDeviceStat	去重设备统计
QueryPushStatByApp	APP维度推送统计
QueryDeviceStat	设备新增与留存
QueryPushStatByMsg	任务维度推送统计
QueryDeviceInfo	查询设备详情
CheckDevices	批量验证设备有效性

公共参数获取

AccessKeyId和AccessKeySecret：在阿里云官网控制台获取
AppKey：在阿里云移动研发控制台，进入应用管理页即可在APP信息上获取

SDK获取

Java SDK 可直接使用以下Maven引用

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-push</artifactId>
    <version>3.13.5</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>[4.3.2,5.0.0)</version>
</dependency>

注：maven官方库更新需要几天时间才能同步，如果maven方式引用失败，请先用上面的git地址下载源码本地编译最新版本jar包。

API概览

API版本号

API更新历史

API概览

推送相关

设备绑定

查询与统计

公共参数获取

SDK获取

Demo