开发者社区> 问答> 正文

消息服务的Notification如何操作?



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此次推送消息的 MessageIdSIMPLIFIED格式下有
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


[backcolor=transparent]请求示例:
[backcolor=transparent]XML 格式
[backcolor=transparent]

[backcolor=transparent]

展开
收起
轩墨 2017-10-24 15:46:14 2085 0
0 条回答
写回答
取消 提交回答
问答排行榜
最热
最新

相关电子书

更多
消息服务在Serverless中的应用 立即下载
阿里云通信战略新品发布 ——国际/港澳台消息服务 立即下载
阿里云通信战略新品发布—国际/港澳台消息服务 立即下载