开发者社区> 问答> 正文

消息服务的Message如何操作?



PublishMessage



描述


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


Request


Request 的构造主要由以下几个部分组成:

  • 请求行

    POST /topics/$TopicName/messages HTTP/1.1

  • 特有 Request Header

    无,通用Header请参考 [backcolor=transparent] 公共参数,签名相关请参考 [backcolor=transparent] API签名

  • Request Body

    Request Body 为 XML 格式
参数名称说明参数值选项
MessageBody消息正文字符集Required
MessageTag消息标签(用于消息过滤)不超过16个字符的字符串(默认没有标签)Optional
MessageAttributes消息属性,如果需要推送邮件或短信,则MessageAttributes为必填项字符集Optional

如果需要推送到MailEndpoint,MessageAttributes需要包含DirectMail属性。DirectMail属性的Text内容是Json格式,需要包含以下字段 (字段含义可以参考 https://help.aliyun.com/document_detail/29444.html ):
  1. AccountName (必选,发信账号,string)。
  2. Subject (必选,邮件主题,string)。
  3. AddressType (必选,0或1)。
  4. IsHtml(必选,邮件内容是否作为Html处理,0或1)。
  5. ReplyToAddress(必选,0或1)。

如果需要推送到SmsEndpoint,MessageAttributes需要包含DirectSMS属性。DirectSMS属性的Text内容是Json格式,需要包含以下字段 :
  1. [backcolor=transparent]FreeSignName (必选,短信签名)。
  2. [backcolor=transparent]TemplateCode (必选,短信模板ID)。
  3. [backcolor=transparent]Type (必选,singleContent或multiContent,表示单发或批量。如果取值为multiContent,则只会被Endpoint为sms:directsms:anonymous 的订阅处理)。
  4. [backcolor=transparent]Receiver (如果Type为singleContent且Subscription的Endpoint是sms:directsms:anonymous ,则此项生效且必填,填写接收人的手机号码,多个号码以逗号分隔)。
  5. [backcolor=transparent]SmsParams (必选,json格式,一些具体参数。对于singleContent,此处填写格式为{“参数1”:”Value1”,”参数2”:”Value2”};对于multiContent,此处填写格式为{“电话号码1”:{“参数1”:”Value1”,”参数2”:”Value2”}, “电话号码2”:{“参数1”:”Value3”,”参数2”:”Value4”}})。


Response


返回消息有返回状态行、HTTP头和消息体三部分组成

  • HTTP Status Code

    HTTP/1.1 201 Created

  • 特有 Response Header

    无,请参考 [backcolor=transparent]调用方式/公共参数

  • Response Body

    返回的结果为 XML 格式,包括 MessageId 和 MessageBodyMD5:
参数名称说明
MessageId消息编号,在主题中唯一
MessageBodyMD5消息正文的 MD5 值


Special Error

错误代码错误信息状态码
TopicNotExistThe topic you provided does not exist.404

[backcolor=transparent]请求示例:
[backcolor=transparent]

[backcolor=transparent]

[backcolor=transparent]

展开
收起
轩墨 2017-10-24 15:45:03 1981 0
0 条回答
写回答
取消 提交回答
问答标签:
问答地址:
问答排行榜
最热
最新

相关电子书

更多
使命必达 —— 钉钉企业级 消息服务的机遇与挑战 立即下载
消息服务在Serverless中的应用 立即下载
使命必达—钉钉企业级消息服务的机遇与挑战 立即下载