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 开发者门户上实际体验调用下述接口。

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