消息通知服务 SMN
消息通知服务 SMN
- 最新动态
- 功能总览
- 产品介绍
- 快速入门
- 用户指南
- 最佳实践
- API参考
- SDK参考
-
常见问题
- 消息通知服务有哪些优势？
- 消息通知服务支持的传输协议有哪些？
- 消息通知服务的使用如何收费和计费？
- 消息通知服务的主题名称有何格式要求？
- 每个用户可以创建多少个主题？
- 每个主题最多支持多少个订阅者？
- 可以向主题发布多少条消息？
- 每个用户可以创建多少个消息模板？
- 以短信方式接收消息的限制是什么？
- 单个主题是否支持通过多种传输协议进行订阅？
- 主题创建者是否可以控制所创建的主题中允许的传输协议？
- 订阅终端地址可以修改吗？
- 是否可删除已发布的消息？
- 是否会保证将消息传送到订阅的终端节点？
- 每条消息会让订阅者收到多少次？
- 向主题推送消息后，订阅者为什么没有收到消息？
- 为什么用户接收到的邮件中图片无法显示？
- 使用消息通知服务发送短信的号码或显示名可以保持一致吗？
- 如何获取用户的账号ID？
- 钉钉机器人、钉钉企业内部机器人、飞书机器人、企业微信机器人如何获取订阅终端？
- 视频帮助
-
更多文档
- 用户指南（阿布扎比区域）
- API参考
- 用户指南 (巴黎区域)
- API参考 (巴黎区域)
- 用户指南（吉隆坡区域）
- API参考（吉隆坡区域）
- 用户指南（安卡拉区域）
- API参考（安卡拉区域）
- 通用参考
链接复制成功！
使用消息结构体方式的消息发布
功能介绍
URI
- 参数说明
请求消息
- 参数说明
名称
是否必选
参数类型
说明
subject
否
String
消息标题，给邮箱订阅者发送邮件时作为邮件主题。
长度不超过512字节。
message_structure
是
String
Json格式的字符串。
支持“email”、“sms”、 “http”、“https”。
必须设置默认的消息“default”，当匹配不到消息协议时，按“default”中的内容发送。
说明：
三种消息发送方式
- message
- message_structure
- message_template_name
只需要设置其中一个，如果同时设置，生效的优先级为message_structure >message_template_name>message
time_to_live
否
String
指消息在SMN系统内部的最长存留时间。
超过该存留时间，系统将不再发送该消息。单位是s，变量默认值是3600，即一小时。
值为正整数且小于等于3600*24*7。
- 请求样例
POST https://{SMN_Endpoint}/v2/{project_id}/notifications/topics/urn:smn:regionId: f96188c7ccaf4ffba0c9aa149ab2bd57:test_create_topic_v2/publish{ "subject": "test message v2", "time_to_live": "3600", "message_structure": "{\n \"default\": \"xxx\",\n \"APNS\": \"{\\\"aps\\\":{\\\"alert\\\":{\\\"title\\\":\\\"xxx\\\",\\\"body\\\":\\\"xxx\\\"}}}\"\n}" }说明：
假设Topic拥有sms和email两种协议订阅者。调用接口发布消息后，email的订阅者会收到消息“abc”，sms协议未定制特殊的推送消息，则会收到默认消息 “test v2 default”。
响应消息
- 要素说明
名称
参数类型
说明
request_id
String
请求的唯一标识ID。
message_id
String
唯一的消息ID。
- 响应样例
{ "message_id": "bf94b63a5dfb475994d3ac34664e24f2", "request_id": "9974c07f6d554a6d827956acbeb4be5f" }
返回值
请参考返回值。
错误码
请参考错误码。
父主题： 发布消息操作
