Publica uma mensagem em um tópico específico. Após a publicação no tópico, o Message Service (MNS) envia a mensagem para os endpoints especificados.
Cabeçalhos da requisição
Esta operação usa apenas cabeçalhos de requisição comuns e não possui cabeçalhos específicos. Para obter mais informações, consulte Parâmetros comuns.
Sintaxe da requisição
POST /topics/$TopicName/messages HTTP/1.1
Antes de chamar esta API para enviar uma mensagem, codifique o corpo da mensagem em Base64. Essa prática evita erros inesperados causados por caracteres especiais.
Parâmetros da requisição
|
Parâmetro |
Tipo |
Obrigatório |
Descrição |
|
MessageBody |
String |
Sim |
Conteúdo da mensagem. |
|
MessageTag |
String |
Não |
Tag da mensagem. |
|
MessageAttributes |
Object |
Não |
Atributos da mensagem. Este parâmetro é opcional ao enviar mensagens para servidores HTTP ou filas. |
Parâmetros de resposta
|
Parâmetro |
Tipo |
Exemplo |
Descrição |
|
MessageId |
String |
D273CD6A89564E54-1-15180395A19-20000**** |
ID da mensagem. O identificador é único no tópico. |
|
MessageBodyMD5 |
String |
3AC6DD36D2D6B7283F2F490A0975**** |
Hash MD5 do corpo da mensagem. |
Exemplos
Exemplo de requisição
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>Exemplo de resposta
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> Códigos de erro
|
Código de erro |
Mensagem de erro |
Código de status HTTP |
|
TopicNotExist |
The topic you provided does not exist. |
404 |