HttpEndpoint - - 阿里云

描述

消息服务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