調用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 |