tencent cloud

腾讯云超级应用服务

订阅消息

Download
聚焦模式
字号
最后更新时间: 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"
}
}
}



帮助和支持

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

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

文档反馈