tencent cloud

腾讯云超级应用服务

动态与公告
【2025年1月2日】关于腾讯云小程序平台更名为腾讯云超级应用服务的公告
控制台更新动态
Android SDK 更新动态
iOS SDK 更新动态
Flutter 更新动态
IDE 更新动态
基础库更新动态
产品简介
产品概述
产品优势
应用场景
购买指南
计费概述
按量计费(后付费)
续费指引
停服说明
快速入门
套餐管理
概述
控制台账号管理
存储配置
加速配置
品牌化配置
平台功能
控制台登录
用户和权限体系
小程序管理
小游戏管理
应用管理
商业化
平台管理
用户管理
团队管理
运营管理
安全中心
代码接入指引
Demo 及 SDK 获取
Android
iOS
Flutter
App 服务端接入指南
GUID 生成规则
小程序开发指南
小程序介绍与开发环境
小程序代码组成
指南
框架
组件
API
服务端
JS SDK
基础库
IDE 使用指南
小游戏开发指南
指南
API
服务端
实践教程
小程序登录实践教程
小程序订阅消息实践教程
支付相关实践教程
广告接入实践教程
小游戏订阅消息实践教程
相关协议
数据处理和安全协议

订阅消息

PDF
聚焦模式
字号
最后更新时间: 2025-01-17 10:52:17



说明:
仅公有云支持。

查询个人模板列表

调用方式:get。
请求地址:/openserver/wxaapi/newtmpl/gettemplate

请求参数

属性
类型
必填
说明
access_token
string
访问凭证

返回参数

属性
类型
说明
errmsg
string
错误信息
errcode
int32
错误码
data
array<object>
模板列表
data.priTmplId
string
模板id
data.title
string
标题
data.content
string
内容
data.example
string
示例
data.type
string
类型
data.keywordEnumValueList
array<object>
枚举列表
data.keywordEnumValueList.keywordCode
string
枚举名
data.keywordEnumValueList.enumValueList
array<string>
枚举值
{
"data": [
{
"content": "testtest400:{{phrase1.DATA}}\\ntesttest401:{{phrase2.DATA}}",
"example": "testtest400:testtest400\\ntesttest401:testtest401",
"keywordEnumValueList": [
{
"enumValueList": [
"To be paid",
"Wait for delivery",
"Has been shipped",
"Completed",
"Canceled"
],
"keywordCode": "enum.DATA"
}
],
"priTmplId": "mti_oAWECeEacUIdYvUxSbJBNbkOIfzJHEcJIRSEMAE",
"title": "testtest400",
"type": 3
},
{
"content": "Order Number:{{thing1.DATA}}\\nOrder type:{{thing2.DATA}}\\nOrder Time:{{date.DATA}}\\nOrder status:{{phrase.DATA}}",
"example": "Order Number:100020241130100001\\nOrder type:Personal order\\nOrder Time:2024/11/30 11:19:00\\nOrder status:Pending shipment",
"keywordEnumValueList": [
{
"enumValueList": [
"To be paid",
"Wait for delivery",
"Has been shipped",
"Completed",
"Canceled"
],
"keywordCode": "enum.DATA"
}
],
"priTmplId": "mti_AgKglmMmSMbFVXBpaFunPSIoDGddPKSFGbSAYRe",
"title": "Received order notification",
"type": 2
}
],
"errcode": 0,
"errmsg": "ok",
"requestId": "19d63f1109f24857961de213bcfc7e75"
}

发送订阅消息

调用方式:post。
请求地址:/openserver/cgi-bin/message/subscribe/send

请求参数

属性
类型
必填
说明
access_token
string
接口调用凭证,该参数为 URL 参数,非 Body 参数
template_id
string
所需下发的订阅模板 id
page
string
单击模板卡片后的跳转页面,仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转
touser
string
接收者(用户)的 openid
data
string
模板内容
miniprogram_state
string
跳转小程序类型:developer 为开发版;trial 为体验版;formal 为正式版;默认为正式版
lang
string
进入小程序“查看”的语言类型,支持zh_CN(简体中文)、en_US(英文)

返回参数

属性
类型
说明
errcode
number
错误码
errmsg
string
错误信息
{"errcode":0,"errmsg":"ok"}

其他说明

订阅消息参数值内容限制说明

参数类别
参数说明
参数值限制
正则表达式
thing.DATA
事物
20个以内字符
^[a-zA-Z0-9!@#$%^&*()_+={}\\[\\]:;\\"\\'<>,.?/~`-]{1,20}$
number.DATA
数字
32位以内数字
^[0-9]{1,32}(\\.[0-9]+)?$
letter.DATA
字母
32位以内字母
^[a-zA-Z]{1,32}$
symbol.DATA
符号
5位以内符号
^[^\\w\\s]{1,5}$
character_string.DATA
字符串
64位以内数字、字母或符号
^[a-zA-Z0-9\\W_]{1,64}$
time.DATA
时间
24小时制时间格式,两个时间用“~”符号连接,格式为:hh:mm:ss 或 hh:mm
^(?:(?:([01]\\d|2[0-3]):([0-5]\\d)(?::([0-5]\\d))?(?:~([01]\\d|2[0-3]):([0-5]\\d)(?::([0-5]\\d))?)?)?)?$
date.DATA
日期
年月日格式,两个时间点之间用“~”符号连接,格式为:yyyy-MM-dd hh:mm:ss 或者yyyy-MM-dd
^(\\d{4}-[01]\\d-[0-3]\\d(?: (?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d)?)(?:~(\\d{4}-[01]\\d-[0-3]\\d(?: (?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d)?))?$
amount.DATA
金额
1个币种符号+10位以内纯数字,可带小数
^[A-Za-z$€¥]{1}[\\d]{0,8}(\\.\\d{1,2})?$
phone_number.DATA
电话
17位以内,数字、符号
^[\\d\\-\\+$$\\s]{1,17}$
car_number.DATA
车牌
12位以内字符
^.{1,12}$
name.DATA
姓名
32位以内字符
^. {1,32}$
phrase.DATA
描述
16位以内字符
^.{1,16}$
例如,模板的内容为:
姓名: {{name01.DATA}}
金额: {{amount01.DATA}}
行程: {{thing01.DATA}}
日期: {{date01.DATA}}
则对应的 json为:
{
"touser": "OPENID",
"template_id": "TEMPLATE_ID",
"page": "index",
"data": {
"name01": {
"value": "某某"
},
"amount01": {
"value": "¥100"
},
"thing01": {
"value": "广州至北京"
},
"date01": {
"value": "2018-01-01"
}
}
}



帮助和支持

本页内容是否解决了您的问题?

填写满意度调查问卷,共创更好文档体验。

文档反馈