Publishes a message to a specified topic. After the message is published to the topic, Message Service (MNS) pushes the message to the specified endpoints.
Request headers
This operation uses only common request headers and does not have operation-specific request headers. For more information, see Common parameters.
Request syntax
POST /topics/$TopicName/messages HTTP/1.1
Before you call this API operation to send a message, encode the message body by using Base64. This prevents unexpected errors due to special characters.
Request parameters
Parameter | Type | Required | Description |
MessageBody | String | Yes | The content of the message. |
MessageTag | String | No | The tag of the message. |
MessageAttributes | Object | No | The message attributes. If you push the message to HTTP servers or queues, you do not need to set the parameter. |
Response parameters
Parameter | Type | Example | Description |
MessageId | String | D273CD6A89564E54-1-15180395A19-20000**** | The ID of the message. The message ID is unique in the topic. |
MessageBodyMD5 | String | 3AC6DD36D2D6B7283F2F490A0975**** | The MD5 hash of the message body. |
Examples
Sample request
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>
Sample response
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>
Error codes
Error code | Error message | HTTP status code |
TopicNotExist | The topic you provided does not exist. | 404 |