使用HttpEndpoint接口，通過發送POST請求將Notifications推送到Endpoint。

描述

消息服務MNS通過發送POST請求將Notifications推送到Endpoint端，Notifications支持兩種格式：

  • 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到消息發布時的毫秒值。

    精簡格式下，Request Body為發布者發布的消息正文。

Response

返回消息由返回狀態行、HTTP頭和消息體三部分組成：

  • HTTP Status Code

    HTTP/1.1 204 No Content

    • 正常處理通知消息，返回204；超過5秒未返回204，則認為超時，對該消息重試推送。
    • 請求簽名驗證不通過，返回403。
    • 其他任何錯誤，返回500。
  • 特有Response Header

    無。

  • Response Body

    無。

示例

請求示例：

  • XML 格式 
        POST /notifications HTTP/1.1
    Host: example.com
    Date: Tue, 08 Dec 2015 06:42:00 GMT
    Content-Length: 300
    Content-Type: text/xml;charset=utf-8
    Content-MD5: OGQzNjAwYjIwMWFiMTliZDlhNzc4YjAwZjc5MGQ4****
    Authorization: QSNS+vn3IqJI4lOh4X/dxTv7Qebi/wrEaBJlzFFTc0hJVRUmrHLQo24ojBUETpz48+jrsjxMGPJTILDw752J****
    User-Agent: Aliyun Notification Service Agent
    x-mns-request-id: 56667BB81FD0E7D12000****
    x-mns-version: 2015-06-06
    x-mns-signing-cert-url: aHR0cDovL21uc3Rlc3Qub3NzLWNuLWhhbmd6aG91LmFsaXl1bmNzLmNvbS94NTA5X3B1YmxpY19jZXJ0aWZpY2F0ZS5w****

    <?xml version="1.0" encoding="utf-8"?>
    <Notification xlmns="http://mns.aliyuncs.com/doc/v1/">
        <TopicOwner>$TopicOwner</TopicOwner>
        <TopicName>$TopicName</TopicName>
        <Subscriber>$Subscriber</Subscriber>
        <SubscriptionName>$SubscriptionName</SubscriptionName>
        <MessageId>6CC4D900CA59A2CD-1-15180534A8F-20000****</MessageId>
        <Message>{1:"a", 2:"b"}</Message>
        <MessageMD5>F1E92841751D795AB325861034B5****</MessageMD5>
        <MessageTag>important</MessageTag>
        <PublishTime>1449556920975</MessagePublishTime>
    </Notification>
  • SIMPLIFIED 格式 
        POST /notifications HTTP/1.1
    Host: example.com
    Date: Tue, 15 Dec 2015 09:12:46 GMT
    Content-Length: 487
    Content-Type: text/plain;charset=utf-8
    Content-MD5: NmY4Njk0MzlmNzg3NTFkMTJiN2M5OWE4ZmYzNTU4****
    Authorization: aXZIpRkRmIavmwceCyrPatB7SaEbOJdWpmFWYX3nFwtmaixK/M/3kl1njY0pgM7mrIB7NlBv5NfUZNkcIjlO****
    User-Agent: Aliyun Notification Service Agent
    x-mns-message-id: 6CC4D900CA59A2CD-1-15180534A8F-20000****
    x-mns-message-tag: important
    x-mns-request-id: 566FD963B2B71C44481F****
    x-mns-signing-cert-url: aHR0cDovL21uc3Rlc3Qub3NzLWNuLWhhbmd6aG91LmFsaXl1bmNzLmNvbS94NTA5X3B1YmxpY19jZXJ0aWZpY2F0ZS5w****
    x-mns-version: 2015-06-06

    {1:"a", 2:"b"}

返回示例：

HTTP/1.1 204 No Content