检测到您已登录华为云国际站账号,为了您更好的体验,建议您访问国际站服务网站 https://www.huaweicloud.com/intl/zh-cn
不再显示此消息
API概览 通过使用消息通知服务所提供的接口,您可以完整的使用消息通知服务的所有功能。例如创建Topic、添加订阅。 表1 接口说明 类型 说明 主题操作 包含创建主题、更新主题、删除主题等接口。 订阅操作 包含查询订阅列表、订阅、取消订阅等接口。 模板操作 包含创建消息模板、更新消息模板、删除消息模板等接口。
在订阅主题时,选择不同的订阅协议,订阅终端接收到的信息是不一样的。 邮件协议 订阅终端为邮箱,接收到的消息包含消息内容和取消订阅的链接。 短信协议 订阅终端为手机,接收到的消息只包含消息内容。 发布区域:全部 向主题推送消息后,订阅者为什么没有收到消息? 为什么用户接收到的邮件中图片无法显示?
请求响应成功后,返回request_id和subscription_urn。 如果请求失败,则会返回错误码及对应的错误信息说明,详细错误码信息请参考错误码。 可为Topic添加多种以及多个订阅终端,支持的订阅协议请参考订阅。 订阅终端会收到一条确认订阅的消息,请在邮箱中进行确认订阅的操作。 发送消息。发送“POST
名称下面对应的协议模板,如果对应的协议模板不存在,则采用默认Default的模板。如果没有预置的Default协议的模板,将不允许发送该模板。 当您需要发送模板格式的消息时,可参考本章节管理消息模板。 创建模板 登录管理控制台。 在管理控制台左上角单击图标,选择区域和项目。 在页面左上角单击图标,选择“管理与监管”
app推送的消息内容,当前支持的推送平台有HMS、APNS、APNS_SANDBOX。 HMS是为开发者提供的消息推送平台。 APNS和APNS_SANDBOX是用于推送iOS消息的服务平台。 HMS平台指定的消息内容不超过2K。 APNS和APNS_SANDBOX平台的消息内容不能超过4K。
属性作用 属性默认值 access_policy Topic资源的访问策略,控制其他用户访问该Topic的权限。 空字符串。 introduction 在邮件和短信订阅确认信息中展示Topic的介绍,使您能够让订阅者对主题有更多的了解。 空字符串。 父主题: 附录
传输中的数据保护 传输中数据保护指在数据传输(发往和离开消息通知服务时)期间保护数据。 向消息通知服务发送消息时,您可以使用Https协议请求消息通知服务接口进行传输加密。消息通知服务向外部系统发送消息时,也支持Https协议发送消息。 父主题: 数据保护技术
发布主题消息简介 消息通知服务提供了以下三种通用的方式。 发布文本格式的消息。 发布JSON格式的消息。 发布模板格式的消息。 一旦一条新的消息已经发布,消息通知服务试图将消息发布至每个已经向主题确认订阅的终端节点。 如果使用短信协议接收消息,对于内容很长的消息,短信长度限制为490字,超出则
改显示名”。在弹出的对话框中输入新的显示名。 或者单击“主题名称”,在主题详情页中,单击显示名右侧的“”图标,输入新的显示名。 推送邮件消息时,如果未设置主题的显示名,发件人呈现为“username@example.com”,如果已设置主题的显示名,发件人则呈现为“显示名<username@example
JSON格式中必须有Default协议。 整个JSON消息的大小不超过256KB。 JSON消息计算 选择不同的协议,生成的JSON格式消息的大小不同。JSON格式消息的字节数包含消息框中显示的花括号、双引号、空格、回车、协议名称和消息内容累计字节数。具体字节计算方式以输入消息“This
对于用户自定义的HTTP(S)头部字段,SMN也将采用上述的处理策略。 用户如果从HTTP(S)头部中获取相关字段,建议采用不区分大小写的方式。 HTTP(S)订阅确认消息的格式 添加HTTP(S)订阅终端以后,SMN会向订阅终端推送一条订阅确认的消息,下面将描述消息的HTTP C
t-Token的值)。 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 application_count Integer 返回的Application个数。该参数不受offset和limit影响
目前SMN服务的订阅管理能力对终端订阅者开放,终端订阅者必须保护好自己的订阅链接,避免被其他人窃取后无法收到或收到非本人期望得到的通知信息。 取消订阅 不同的订阅协议对应不同的取消订阅方式: 短信取消订阅:因为短信长度有限,无法每次推送消息时候附带取消订阅的链接,用户需通过请
t-Token的值)。 响应参数 状态码: 200 表4 响应Body参数 参数 参数类型 描述 request_id String 请求的唯一标识ID。 topic_count Integer 返回的Topic个数。该参数不受offset和limit影响,即返回的是您账户下所有的Topic个数。
String 应用平台。 目前仅支持HMS、APNS、APNS_SANDBOX。 HMS是为开发者提供的消息推送平台。 APNS和APNS_SANDBOX是用于推送iOS消息的服务平台。 platform_principal 是 String 对于HMS平台是APP ID,只能包含英文字母和数字,最大20个字符。
同时设置,生效的优先级为message_structure > message_template_name > message。 tags 否 Map<String,String> tag以及替换tag的参数组成的字典。消息模板中的标签对应的值。使用消息模板方式的消息发布必须携带
创建Topic,单用户默认配额为3000。高并发场景下,可能会出现Topic数量超过3000仍创建成功的情况,此为正常现象。 接口是幂等的,接口调用返回成功时,若已存在同名的Topic,返回的status code为200,否则返回的status code为201 调用方法 请参见如何调用API。 URI POST
获取(响应消息头中X-Subject-Token的值)。 表3 请求Body参数 参数 是否必选 参数类型 描述 message_template_name 是 String 创建模板的名称。只能包含大写字母、小写字母、数字、-和_,且必须由大写字母、小写字母或数字开头,长度在1到64个字符之间。