All Products
Search
Document Center

:PublishMessage

Last Updated:Dec 12, 2023

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

Note

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