292      阿里云

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

描述

该接口用于发布者向指定的主题发布消息，消息发布到主题后随即会被推送给 Endpoint 消费。

Request

Request 的构造主要由以下几个部分组成：

• 请求行

  POST /topics/$TopicName/messages HTTP/1.1

• 特有 Request Header

  无，请参考 调用方式/公共参数

• Request Body

  Request Body 为 XML 格式

如果需要推送到MailEndpoint，MessageAttributes需要包含DirectMail属性。
DirectMail属性的Text内容是Json格式，需要包含以下字段
(字段含义可以参考https://help.aliyun.com/document_detail/29444.html )：

1. AccountName (必选，发信账号，string)
2. Subject (必选，邮件主题，string)
3. AddressType (必选，0或1)
4. IsHtml(必选，邮件内容是否作为Html处理，0或1)
5. ReplyToAddress(必选，0或1)

Response

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

• HTTP Status Code

  HTTP/1.1 201 Created

• 特有 Response Header

  无，请参考 调用方式/公共参数

• Response Body

  返回的结果为 XML 格式，包括 MessageId 和 MessageBodyMD5：

Special Error

请求示例：

    POST /topics/$TopicName/messages HTTP/1.1
    Host: $AccountId.mns.cn-hangzhou.aliyuncs.com
    Date: Tue, 08 Dec 2015 06:13:40 GMT
    Content-Length:500
    Content-Type:text/xml;charset=utf-8
    Authorization: MNS 15B4D3461F177624206A:aibzWu1iDEx9LwO56+kHgA3eqmI=
    x-mns-version: 2015-06-06
    <?xml version="1.0" encoding="utf-8"?>
    <Message xmlns="https://mns.aliyuncs.com/doc/v1/">
        <MessageBody>Base64 Encoded Result</MessageBody>
        <MessageTag>important</MessageTag>
        <MessageAttributes>
            <DirectMail>{"Subject":"TestMailSubject","AccountName":"direct_mail_account_name@aliyun-inc.com","ReplyToAddress":0,"AddressType":0,"IsHtml":0}</DirectMail>
        </MessageAttributes>
    </Message>

返回示例：

    HTTP/1.1 201 Created
    Content-Length:120
    Content-Type:text/xml;charset=utf-8
    x-mns-request-id:56667514B2B71C9C1600002B
    x-mns-version:2015-06-06
    <?xml version="1.0" encoding="utf-8"?>
    <Message xmlns="https://mns.aliyuncs.com/doc/v1/">
        <MessageId>D273CD6A89564E54-1-15180395A19-200000001</MessageId>
        <MessageBodyMD5>3AC6DD36D2D6B7283F2F490A09751BFE</MessageBodyMD5>
    </Message>