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