全部产品
物联网行业方案

推消息给Android设备

更新时间:2018-03-22 19:07:53

PushMessageToAndroid

描述

推送消息给Android设备。

注:该接口默认只发送给在线设备,要发送离线保存消息请用 推送高级接口

请求参数

名称 类型 是否必须 描述
Action String 操作接口名称,取值:PushMessageToAndroid
AppKey Long AppKey信息
Target String 推送目标:
  • DEVICE:根据设备推送
  • ACCOUNT:根据账号推送
  • ALIAS:根据别名推送
  • TAG:根据标签推送
  • ALL:推送给全部设备
TargetValue String 根据Target来设定,多个值使用逗号分隔,最多支持100个。
  • Target=DEVICE,值如deviceid111,deviceid1111
  • Target=ACCOUNT,值如account111,account222
  • Target=ALIAS,值如alias111,alias222
  • Target=TAG,支持单Tag和多Tag,格式请参考 标签格式
  • Target=ALL,值为all
Title String 发送的消息的标题
Body String 发送的消息内容

响应参数

名称 类型 描述
MessageId String 标志一次推送的消息ID

错误码

错误代码 描述 HTTP 状态码 语义
InvalidDeviceType.NotMatch Specified DeviceType does no match the app. 400 DeviceType和指定app的类型不匹配
AppNotConfigAndroid The PackageName of specified app is not configured. 400 没有配置PackageName
InvalidPayload.BytesExceed Specified Payload exceeds the 1800 bytes limit. 400 消息内容长度超限

示例

请求示例

  1. http://cloudpush.aliyuncs.com/?Action=PushMessageToAndroid
  2. &AppKey=23267207
  3. &Target=ALL&
  4. &TargetValue=ALL
  5. &Title=title
  6. &Body=body
  7. &<公共请求参数>

返回示例

XML格式

  1. <?xml version="1.0" encoding="UTF-8"?>
  2. <PushMessageToAndroidResponse>
  3. <RequestId>9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC</RequestId>
  4. <MessageId>501029</MessageId>
  5. </PushMessageToAndroidResponse>

JSON格式

  1. {
  2. "RequestId": "9998B3CC-ED9E-4CB3-A8FB-DCC61296BFBC",
  3. "MessageId": "501029"
  4. }