调用PublishMessage接口向指定的主题发布消息,消息发布到主题后随即会被推送给Endpoint消费-阿里云帮助中心

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

请求头

该接口使用公共请求头，无特殊请求头。更多信息，请参见公共参数。

请求语法

POST /topics/$TopicName/messages HTTP/1.1

说明

当您调用API发送消息时，请事先将消息体进行Base64编码，以免存在特殊字符导致不能正常使用。

请求参数

参数	类型	是否必选	描述
MessageBody	String	是	消息内容。
MessageTag	String	否	消息标签。
MessageAttributes	Object	否	消息属性。推送到Queue和HTTP时不需要设置。

返回数据

参数	类型	示例值	说明
MessageId	String	D273CD6A89564E54-1-15180395A19-20000****	消息编号。在主题中唯一。
MessageBodyMD5	String	3AC6DD36D2D6B7283F2F490A0975****	消息正文的MD5值。

示例

请求示例

POST /topics/MyTopic/messages HTTP/1.1
Host: 123456789098****.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 15B4D3461F177624****:aibzWu1iDEx9LwO56+kHgA3e****
x-mns-version: 2015-06-06

<?xml version="1.0" encoding="UTF-8"?>
<Message xmlns="http://mns.aliyuncs.com/doc/v1">
    <MessageBody>hello topic</MessageBody>
</Message>

返回示例

HTTP/1.1 201 Created
Content-Length:120
Content-Type:text/xml;charset=utf-8
x-mns-request-id:56667514B2B71C9C1600****
x-mns-version:2015-06-06

<?xml version="1.0" encoding="utf-8"?>
<Message xmlns="http://mns.aliyuncs.com/doc/v1/">
    <MessageId>D273CD6A89564E54-1-15180395A19-20000****</MessageId>
    <MessageBodyMD5>3AC6DD36D2D6B7283F2F490A0975****</MessageBodyMD5>
</Message>

错误码

错误码	错误信息	状态码
TopicNotExist	The topic you provided does not exist.	404