更新时间:2024-04-19 GMT+08:00
发布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 创建主题
- 在“创建主题”页面中,设置“主题名称”为“Mytopic”。
更多关于“创建主题”的配置指导,请参见创建主题。
- 单击“确定”,主题创建成功。
- 单击主题名称,可查看主题详情(包含主题URN、显示名等)、主题订阅总数。
步骤2 添加订阅
- 在左侧导航栏,选择“主题管理” >“订阅”。
- 在订阅页面。单击“添加订阅”,开始添加消息订阅。
图3 添加订阅
- 为主题“Mytopic”添加协议类型为“短信”的订阅。
- 单击“主题名称”输入框右侧的,在弹出的选择主题对话框中选择主题“Mytopic”。
- 在“协议”下拉框中,选择订阅终端支持的协议“短信”。
- 在“订阅终端”输入框中输入对应的订阅终端,例如“+8618512345678”。
- 单击“确定”,完成协议类型为“短信”的订阅的添加。
- 为主题“Mytopic”添加协议类型为“邮件”的订阅。
- 单击“主题名称”输入框右侧的,在弹出的选择主题对话框中选择主题“Mytopic”。
- 在“协议”下拉框中,选择订阅终端支持的协议“邮件”。
- 在“订阅终端”输入框中输入对应的订阅终端,例如“username@example.com”。
- 单击“确定”,完成协议类型为“邮件”的订阅的添加。
- 更多关于“添加订阅”的参数,请参见添加订阅。
- 为了防止恶意攻击订阅终端,云平台会对订阅终端进行流控保护,触发流控规则后,消息通知服务不再发送订阅确认消息,具体的保护规则请参见《消息通知服务用户指南》的附录“订阅确认流控说明”部分。
- 消息通知服务不会校验订阅终端是否真实存在。
- 添加订阅后,消息通知服务会向订阅终端发送订阅确认信息,信息中包含订阅确认的链接。订阅确认的链接在48小时内有效,用户需要及时在手机端、邮箱或其他协议终端确认订阅。
步骤3 发布消息
- 在左侧导航栏,选择“主题管理” > “主题”。
- 在主题列表中,单击“Mytopic”主题消息右侧“操作”列的“发布消息”。
- 在“发布消息”页面,设置“消息类型”和“消息内容”。
- 主题名称:已选择的需要发布消息的主题名称,不可修改。
- 消息类型:选择“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消息。
图6 发布JSON消息
- 单击“确定”,消息将推送至不同的订阅终端。
各个终端接收到的消息内容说明请参考“不同协议消息说明”部分。