文档首页 > > 快速入门> 发布JSON消息

发布JSON消息

分享
更新时间:2020/09/16 GMT+08:00

操作场景

消息通知服务能够根据用户的需求,向订阅终端主动推送消息。消息通知服务支持发布JSON消息,可通过一次消息发布,向不同类型的订阅者发布不同内容的消息。

本章节以创建主题并发布JSON消息为例,指导您快速上手消息通知服务。

在本示例中,

  • 创建一个主题“Mytopic”。
  • 为主题“Mytopic”添加协议类型为“短信”和“邮件”的订阅。
  • 向“短信”类型的订阅者发布消息“Dear Sir or Madam, this is an SMS message.”。
  • 向“邮件”类型的订阅者发布消息“Dear Sir or Madam, this is an Email message.”

操作流程

通过主题发布JSON消息的流程如图1所示。

图1 发布JSON消息流程

步骤1 创建主题

  1. 登录管理控制台。
  2. 在管理控制台左上角单击图标,选择区域和项目。
  3. 选择“应用服务” > “消息通知服务”。

    进入消息通知服务页面。

  4. 在左侧导航栏,选择“主题管理” > “主题”。

    进入主题页面。

  5. 在主题页面,单击“创建主题”。
    图2 创建主题
  6. 在“创建主题”页面中,设置“主题名称”为“Mytopic”。

    更多关于“创建主题”的配置指导,请参见创建主题

  7. 单击“确定”,主题创建成功。

    主题创建成功后,系统会自动生成主题URN,主题URN是主题的唯一资源标识,不可修改。新创建的主题将显示在主题列表中。

  8. 单击主题名称,可查看主题详情(包含主题URN、显示名等)、主题订阅总数。
    图3 主题详情和主题订阅总数

步骤2 添加订阅

  1. 在左侧导航栏,选择“主题管理” >“订阅”。
  2. 在订阅页面。单击“添加订阅”,开始添加消息订阅。

    此时将显示“添加订阅”页面。

    图4 添加订阅
  3. 为主题“Mytopic”添加协议类型为“短信”的订阅。
    在“添加订阅”页面,
    1. 单击“主题名称”输入框右侧的,在弹出的选择主题对话框中选择主题“Mytopic”。
    2. 在“协议”下拉框中,选择订阅终端支持的协议“短信”。
    3. 在“订阅终端”输入框中输入对应的订阅终端,例如“+8618512345678”。
      当需要添加多个订阅终端时,以换行符隔开。
      图5 添加订阅(短信)
    4. 单击“确定”,完成协议类型为“短信”的订阅的添加。
  4. 为主题“Mytopic”添加协议类型为“邮件”的订阅。
    在“添加订阅”页面,
    1. 单击“主题名称”输入框右侧的,在弹出的选择主题对话框中选择主题“Mytopic”。
    2. 在“协议”下拉框中,选择订阅终端支持的协议“邮件”。
    3. 在“订阅终端”输入框中输入对应的订阅终端,例如“username@example.com”。
      当需要添加多个订阅终端时,以换行符隔开。
      图6 添加订阅(邮件)
    4. 单击“确定”,完成协议类型为“邮件”的订阅的添加。

      完成订阅添加后,您的订阅终端会收到订阅确认的通知,您需要在订阅终端上完成订阅确认,才可以收到主题发布的消息。

    • 更多关于“添加订阅”的参数,请参见添加订阅
    • 为了防止恶意攻击订阅终端,我们会对订阅终端进行流控保护,触发流控规则后,消息通知服务不再发送订阅确认消息,具体的保护规则请参见《消息通知服务用户指南》的附录“订阅确认流控说明”部分。
    • 消息通知服务不会校验订阅终端是否真实存在。
    • 订阅确认的链接在48小时内有效,用户需要及时在手机端、邮箱或其他协议终端确认订阅。

步骤3 发布消息

  1. 在左侧导航栏,选择“主题管理” > “主题”。

    进入主题页面。

  2. 在主题列表中,单击“Mytopic”主题消息右侧“操作”列的“发布消息”。
  3. 设置“消息类型”和“消息内容”。

    在“发布消息”页面,

    • 主题名称:已选择的需要发布消息的主题名称,不可修改。
    • 消息类型:选择“JSON消息”。
    • 消息内容:
      {
        "default": "Dear Sir or Madam, this is a default message.",
        "sms": "Dear Sir or Madam, this is an SMS message.",
        "email": "Dear Sir or Madam, this is an Email message."
      }

      “消息内容”的设置方法请参见向主题发布JSON消息

    图7 发布JSON消息
  4. 单击“确定”,消息将推送至不同的订阅终端。

    各个终端接收到的消息内容说明请参考“不同协议消息说明”部分。

步骤4 接收消息

在订阅主题时,选择不同的订阅协议,订阅终端接收到的信息是不一样的。
  • 邮件协议

    订阅终端为邮箱,接收到的消息包含消息内容和取消订阅的链接。

    图8 邮件消息
  • 短信协议

    订阅终端为手机,接收到的消息只包含消息内容。

    图9 短信消息
分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!非常感谢您的反馈,我们会继续努力做到更好!
反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问