Http Endpoint
描述
MNS 通过发送 POST 请求将 Notifications 推送到 Endpoint 端,Notifications 格式支持两种:XML 完整格式和 SIMPLIFIED 精简格式。XML 完整格式会在 Request Body 中包含推送消息的正文和消息的 Meta 信息;SIMPLIFIED 精简格式的 Request Body 即为用户的消息正文,不做任何改动,MessageId 会在 Request Header 中传递给用户。
Request 的构造由以下几个部分组成:
POST /notifications HTTP/1.1默认是 /notifications,如果订阅者在创建 Subscription 时指定的 Endpoint 包含 URI,会使用用户设置的 URI 替换 /notifications
无
参数名称 | 说明 | 备注 |
Authorization | 此次推送请求的签名 | XML 和 SIMPLIFIED格式下均有 |
x-mns-signing-cert-url | 签名证书的地址(Base64编码过) | XML 和 SIMPLIFIED格式下均有 |
x-mns-request-id | 此次推送消息的 Request 编号 | XML 和 SIMPLIFIED格式下均有 |
x-mns-message-id | 此次推送消息的 MessageId | SIMPLIFIED格式下有 |
x-mns-message-tag | 此次推送消息的消息标签 | SIMPLIFIED格式下有 |
XML 格式下,Request Body 为 XML 格式,包含消息正文和 Meta 信息。
参数名称 | 说明 |
TopicOwner | 被订阅主题的拥有者 |
TopicName | 被订阅主题的名称 |
Subscriber | 订阅者 |
SubscriptionName | 订阅名称 |
MessageId | 消息编号 |
Message | 消息正文 |
MessageMD5 | 消息的 MD5 值 |
MessageTag | 消息标签(用于消息过滤) |
PublishTime | 消息的发布时间,从 1970-1-1 00:00:00 000 到消息发布时的毫秒值 |
| 签名证书的地址(仅XML格式有,注:不建议使用,仅为兼容内测用户,2016年7月份已经不再支持) |
精简格式下,Request Body 为发布者发布的消息正文。
返回消息由返回状态行、HTTP头和消息体三部分组成
HTTP/1.1 204 No Content正常处理通知消息,返回 204;请求签名验证不通过,返回 403;其他任何错误,返回 500。
无
无
版权声明:本文内容由阿里云实名注册用户自发贡献,版权归原作者所有,阿里云开发者社区不拥有其著作权,亦不承担相应法律责任。具体规则请查看《阿里云开发者社区用户服务协议》和《阿里云开发者社区知识产权保护指引》。如果您发现本社区中有涉嫌抄袭的内容,填写侵权投诉表单进行举报,一经查实,本社区将立刻删除涉嫌侵权内容。