文档首页/ 消息通知服务 SMN/ 快速入门/ 通过SMN发布JSON消息
更新时间:2024-09-30 GMT+08:00

通过SMN发布JSON消息

操作场景

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

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

操作流程

操作步骤

说明

准备工作

注册华为账号并开通华为云,实名认证,为账户充值。

步骤一:创建主题

创建一个主题“Mytopic”。

步骤二:添加订阅

为主题“Mytopic”添加协议类型为“短信”和“邮件”的订阅。

步骤三:发布消息

  • 向“短信”类型的订阅者发布消息“Dear Sir or Madam, this is an SMS message.”。
  • 向“邮件”类型的订阅者发布消息“Dear Sir or Madam, this is an Email message.”。

步骤四:接收消息

订阅终端接收消息。

准备工作

  1. 注册账号并实名认证。

    在使用消息通知服务之前,请先注册华为账号并开通华为云实名认证

    如果您已开通华为云并进行实名认证,请忽略此步骤。

  2. 为账户充值。

    请保证账户有足够金额。具体操作,请参见账户充值

步骤一:创建主题

  1. 登录控制台,进入创建主题页面。
  2. 配置主题参数。
    本示例中仅解释必要参数,其余大多数配置可保留默认值。关于配置参数的详细说明请参见创建主题
    图1 创建主题参数配置
    表1 创建主题参数设置说明

    参数

    示例

    说明

    主题名称

    Mytopic

    输入创建的主题名称。

    企业项目

    default

    该参数仅对开通企业项目的企业客户账号显示,不显示时请忽略。

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

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

步骤二:添加订阅

分别为主题“Mytopic”添加协议类型为“短信”和“邮件”的订阅。

  1. 在主题列表中,单击“Mytopic”主题右侧的“添加订阅”。
  2. 配置订阅参数。

    本示例仅解释必要参数,其余大多数配置可保留默认值。关于配置参数的详细说明,请参见添加订阅

    图2 添加订阅配置参数
    表2 添加订阅参数设置说明

    参数

    示例

    说明

    主题名称

    Mytopic

    已选择的需要添加订阅的主题名称,不可修改。

    协议

    短信

    在“协议”下拉框中,选择订阅终端支持的协议“短信”。

    更多支持的协议类型,请参见消息通知服务支持的传输协议有哪些?

    订阅终端

    +8618612345678

    在“订阅终端”输入框中输入有效的手机号码。

    • 批量添加时,每个终端地址占一行,最多可输入10个终端。
    • 消息通知服务不会校验订阅终端是否真实存在。
  3. 单击“确定”,完成协议类型为“短信”的订阅的添加。

    完成订阅添加后,您添加的订阅终端会收到订阅确认的通知,接收端需要在订阅终端上单击订阅确认链接,确认同意接收主题发布的消息。此时SMN页面可以看到对应订阅状态为已确认。

  1. 在主题列表中,单击“Mytopic”主题右侧的“添加订阅”。
  2. 配置订阅参数。

    本示例仅解释必要参数,其余大多数配置可保留默认值。关于配置参数的详细说明,请参见添加订阅

    图3 添加订阅配置参数
    表3 添加订阅参数设置说明

    参数

    示例

    说明

    主题名称

    Mytopic

    已选择的需要添加订阅的主题名称,不可修改。

    协议

    邮件

    在“协议”下拉框中,选择订阅终端支持的协议“邮件”。

    更多支持的协议类型,请参见消息通知服务支持的传输协议有哪些?

    订阅终端

    username@example.com

    在“订阅终端”输入框中输入有效的邮箱地址。

    • 批量添加时,每个终端地址占一行,最多可输入10个终端。
    • 消息通知服务不会校验订阅终端是否真实存在。
  3. 单击“确定”,完成协议类型为“邮件”的订阅的添加。

    完成订阅添加后,您添加的订阅终端会收到订阅确认的通知,接收端需要在订阅终端上单击订阅确认链接,确认同意接收主题发布的消息。此时SMN页面可以看到对应订阅状态为已确认。

步骤三:发布消息

  1. 在主题列表中,单击“Mytopic”主题右侧“操作”列的“发布消息”。
  2. 配置发布消息参数。
    本示例中仅解释必要参数,其余大多数配置可保留默认值。关于配置参数的详细说明请参见向主题发布JSON消息
    图4 发布消息配置参数
    表4 发布消息参数设置说明

    参数

    示例

    说明

    主题名称

    Mytopic

    已选择需要发布消息的主题名称,不可修改。

    消息类型

    JSON消息

    按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格式的消息,或通过单击“生成JSON消息”自动生成消息。

    JSON格式的消息描述,请参见JSON格式消息说明

  3. 单击“确定”,消息将推送至不同的订阅终端。

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

步骤四:接收消息

在订阅主题时,选择不同的订阅协议,订阅终端接收到的信息不同。

  • 短信协议

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

  • 邮件协议

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