描述
推送通知给iOS。
请求参数
名称 | 类型 | 是否必须 | 描述 |
Action | String | 是 | 操作接口名称,取值:PushNoticeToiOS |
AppKey | Long | 是 | AppKey信息 |
Target | String | 是 | 推送目标:
|
TargetValue | String | 是 | 根据Target来设定,多个值使用逗号分隔,最多支持100个。
|
ApnsEnv | String | 是 | iOS的通知是通过APNS中心来发送的,需要填写对应的环境信息,DEV表示开发环境,PRODUCT表示生产环境 |
Title | String | 否 | 发送的通知的标题(iOS10以上才会显示,可不填) |
Body | String | 是 | 发送的通知内容 |
ExtParameters | String | 否 | 自定义的KV结构,开发者扩展用,针对iOS设备(注意 : 该参数要以json map的格式传入,否则会解析出错) |
名称 | 类型 | 描述 |
MessageId | String | 标志一次推送的消息ID |
错误代码 | 描述 | HTTP 状态码 | 语义 |
InvalidTarget | Target must be [DEVICE、ACCOUNT、TAG、ALIAS、ALL]. | 400 | Target只能取DEVICE、ACCOUNT、TAG、ALIAS、ALL其中之一进行发送 |
InvalidParameter | The specified Title.length can not be greater than 60.] | 400 | Title不能大于60个Byte(中文算三个) |
AppLimitExceed | The specified payload beyond the permitted range(1800Byte).] | 400 | 请求内容超过系统限制,请参考产品限制 |
InvalidJsonExtParameter | The specified ExtParameter is not valid json format of map. | 400 | ExtParameter参数应为json格式的map结构 |
InvalidEnv | Env must be [DEV、PRODUCT]. | 400 | iOS的发送环境取DEV或者PRODUCT |
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。
要向iOS设备推送通知,您需要构造一个HTTP请求,包含特定的参数以确保消息能够正确送达目标设备。以下是根据您的需求整理的操作指南和参数说明:
Action: 必填,设置为PushNoticeToiOS
,表示此请求用于向iOS设备推送通知。
AppKey: 必填,提供您的阿里云推送服务AppKey信息。
Target: 必填,指定推送目标。可选值包括:
DEVICE
: 根据设备ID推送,值如:deviceid111,deviceid1111
ACCOUNT
: 根据账号推送,值如:account111,account222
ALIAS
: 根据别名推送,值如:alias111,alias222
TAG
: 根据标签推送,支持单个或多个标签,格式请参考官方文档。ALL
: 推送给全部设备,值为:all
ApnsEnv: 必填,指定iOS的通知环境。取值为DEV
(开发环境)或PRODUCT
(生产环境)。
Title: 非必填,但iOS 10及以上系统会显示通知标题,长度限制请注意不要超过60个字节。
Body: 必填,推送的通知内容。
ExtParameters: 非必填,自定义的键值对结构,供开发者扩展使用。注意:该参数必须是JSON map格式,否则会导致解析错误。
JobKey
、iOSBadge
等高级功能配置,可根据实际需求添加到请求中。InvalidTarget
、InvalidParameter
(特别是关于Title长度和Payload大小)、InvalidJsonExtParameter
以及InvalidEnv
等。虽然具体URL被省略,但构建请求时应遵循如下格式(请替换方括号内的内容为实际值):
http://cloudpush.aliyuncs.com/
?Action=PushNoticeToiOS
&AppKey=您的AppKey
&Target=DEVICE,ACCOUNT,ALIAS,TAG,ALL之一及对应值
&ApnsEnv=DEV或PRODUCT
&Title=您的通知标题
&Body=您的通知内容
&ExtParameters={"key1":"value1","key2":"value2"} // JSON格式的自定义参数
// 可选其他高级参数,如: &iOSMusic=音频文件名
请根据实际情况调整上述示例中的参数,并确保遵守每个参数的规则与限制,以成功完成iOS设备的通知推送。