全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
消息服务

Notification操作

更新时间:2017-06-07 13:26:11

Http Endpoint

描述

MNS 通过发送 POST 请求将 Notifications 推送到 Endpoint 端,Notifications 格式支持两种:XML 完整格式和 SIMPLIFIED 精简格式。
XML 完整格式会在 Request Body 中包含推送消息的正文和消息的 Meta 信息;
SIMPLIFIED 精简格式的 Request Body 即为用户的消息正文,不做任何改动,MessageId 会在 Request Header 中传递给用户。

Request

Request 的构造由以下几个部分组成:

  • 请求行

    POST /notifications HTTP/1.1
    默认是 /notifications,如果订阅者在创建 Subscription 时指定的 Endpoint 包含 URI,会使用用户设置的 URI 替换 /notifications

  • 特有 URI 参数

  • 特有 Request Header

参数名称 说明 备注
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格式下有
  • Request Body

    XML 格式下,Request Body 为 XML 格式,包含消息正文和 Meta 信息。

参数名称 说明
TopicOwner 被订阅主题的拥有者
TopicName 被订阅主题的名称
Subscriber 订阅者
SubscriptionName 订阅名称
MessageId 消息编号
Message 消息正文
MessageMD5 消息的 MD5 值
MessageTag 消息标签(用于消息过滤)
PublishTime 消息的发布时间,从 1970-1-1 00:00:00 000 到消息发布时的毫秒值
SigningCertURL 签名证书的地址(仅XML格式有,注:不建议使用,仅为兼容内测用户,2016年7月份已经不再支持

精简格式下,Request Body 为发布者发布的消息正文。

Response

返回消息由返回状态行、HTTP头和消息体三部分组成

  • HTTP Status Code

    HTTP/1.1 204 No Content
    正常处理通知消息,返回 204;
    请求签名验证不通过,返回 403;
    其他任何错误,返回 500。

  • 特有 Response Header

  • Response Body

请求示例:

XML 格式

  1. POST /notifications HTTP/1.1
  2. Host: company.com
  3. Date: Tue, 08 Dec 2015 06:42:00 GMT
  4. Content-Length: 300
  5. Content-Type: text/xml;charset=utf-8
  6. Content-MD5: OGQzNjAwYjIwMWFiMTliZDlhNzc4YjAwZjc5MGQ4NDE=
  7. Authorization: QSNS+vn3IqJI4lOh4X/dxTv7Qebi/wrEaBJlzFFTc0hJVRUmrHLQo24ojBUETpz48+jrsjxMGPJTILDw752Jww==
  8. User-Agent: Aliyun Notification Service Agent
  9. x-mns-request-id: 56667BB81FD0E7D1200024A0
  10. x-mns-version: 2015-06-06
  11. x-mns-signing-cert-url: aHR0cDovL21uc3Rlc3Qub3NzLWNuLWhhbmd6aG91LmFsaXl1bmNzLmNvbS94NTA5X3B1YmxpY19jZXJ0aWZpY2F0ZS5wZW0=
  12. <?xml version="1.0" encoding="utf-8"?>
  13. <Notification xlmns="http://mns.aliyuncs.com/doc/v1/">
  14. <TopicOwner>$TopicOwner</TopicOwner>
  15. <TopicName>$TopicName</TopicName>
  16. <Subscriber>$Subscriber</Subscriber>
  17. <SubscriptionName>$SubscriptionName</SubscriptionName>
  18. <MessageId>6CC4D900CA59A2CD-1-15180534A8F-200000002</MessageId>
  19. <Message>{1:"a", 2:"b"}</Message>
  20. <MessageMD5>F1E92841751D795AB325861034B5CB55</MessageMD5>
  21. <MessageTag>important</MessageTag>
  22. <PublishTime>1449556920975</MessagePublishTime>
  23. </Notification>

SIMPLIFIED 格式

  1. POST /notifications HTTP/1.1
  2. Host: company.com
  3. Date: Tue, 15 Dec 2015 09:12:46 GMT
  4. Content-Length: 487
  5. Content-Type: text/plain;charset=utf-8
  6. Content-MD5: NmY4Njk0MzlmNzg3NTFkMTJiN2M5OWE4ZmYzNTU4ZWQ=
  7. Authorization: aXZIpRkRmIavmwceCyrPatB7SaEbOJdWpmFWYX3nFwtmaixK/M/3kl1njY0pgM7mrIB7NlBv5NfUZNkcIjlO4A==
  8. User-Agent: Aliyun Notification Service Agent
  9. x-mns-message-id: 6CC4D900CA59A2CD-1-15180534A8F-200000002
  10. x-mns-message-tag: important
  11. x-mns-request-id: 566FD963B2B71C44481F701A
  12. x-mns-signing-cert-url: aHR0cDovL21uc3Rlc3Qub3NzLWNuLWhhbmd6aG91LmFsaXl1bmNzLmNvbS94NTA5X3B1YmxpY19jZXJ0aWZpY2F0ZS5wZW0=
  13. x-mns-version: 2015-06-06
  14. {1:"a", 2:"b"}

返回示例:

  1. HTTP/1.1 204 No Content
本文导读目录