基本概念
协议
SMN支持发送的消息类型,包括邮件、HTTP(S)、短信。
发布者
消息发布者,向主题发送消息的对象。
订阅者
消息订阅者,从主题接收消息的订阅终端。
添加订阅时,用户可以根据需要选择不同的传输协议,每种协议对应不同类型的订阅者,具体对应关系如下所示:
- 邮件传输协议,订阅者为邮箱地址。
- 短信传输协议,订阅者为手机号码。
- HTTP/HTTPS传输协议,订阅者为URL。
主题
主题是消息发布或客户端订阅通知的特定事件类型。它作为发送消息和订阅通知的信道,是消息隔离基本单元,为发布者和订阅者提供一个可以相互交流的通道。
URN
URN是SMN用来标识资源的字符串,目前存在以下几种类型。
- 主题URN
创建主题后,SMN将为该主题分配的唯一资源标识,其中包括服务名称(SMN)、区域名称、项目ID和主题名称。形如:urn:smn:region:cffe4fc4c9a54219b60dbaf7b586e132:Mytopic。主题URN将作为创建主题时使用的API调用的一部分返回。无论何时发布者或者订阅者需要对该主题执行任何操作,都应引用该唯一主题URN。
- 订阅URN
成功订阅主题后,由系统生成的订阅者唯一资源标识,其中包括服务名称(SMN)、区域名称、项目ID、主题名称、订阅ID等。形如:urn:smn:region:cffe4fc4c9a54219b60dbaf7b586e132:Mytopic:5293b436967f450abc51e0c36347b27a。在您确认订阅和取消订阅时,页面会显示订阅URN,方便您确认是否操作正确。
消息模板
消息模板指消息内容的固定格式。发布消息时可以使用已创建的消息模板生成模板消息。如果消息模板中存在模板变量,生成模板消息时系统会将模板变量自动替换为用户设置的参数值。
模板变量
创建消息模板时,在消息模板里设置的变量。在使用消息模板发送消息时,可以使用参数值来替换此变量。
如:“The Arts and Crafts Exposition will be held from {startdate} through {enddate}. We sincerely invite you to join us.”其中,“{startdate}”和“{enddate}”即为模板变量。