942      阿里云  技术社区[云栖]

Notification操作__主题接口规范_API使用手册_消息服务-阿里云

描述

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

• Request Body

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

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

Response

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

• HTTP Status Code

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

• 特有 Response Header

  无

• Response Body

  无

请求示例：

XML 格式

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

SIMPLIFIED 格式

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

    HTTP/1.1 204 No Content