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

请求头

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

请求语法

POST /topics/$TopicName/messages HTTP/1.1

请求参数

参数 类型 是否必选 描述
MessageBody String 消息内容。
MessageTag String 消息标签。
MessageAttributes Object 推送订阅类型。
取值说明如下:
  • HTTP:HTTP网关。
  • Queue:队列。

返回数据

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

示例

正常返回示例

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