发布JSON消息

操作场景

消息通知服务能够根据用户的需求，向订阅终端主动推送消息。消息通知服务支持发布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 接收消息