微信小程序服务器端文档,send-微信小程序服务端文档(201912)-面试哥

subscribeMessage.send本接口应在服务器端调用，详细说明参见服务端API。

本接口支持云调用。需开发者工具版本 >= 1.02.1904090(最新稳定版下载)，wx-server-sdk >= 0.4.0

发送订阅消息

调用方式：

HTTPS 调用

请求地址POST https://api.weixin.qq.com/cgi-bin/message/subscribe/send?access_token=ACCESS_TOKEN

请求参数属性类型默认值必填说明access_tokenstring是

touserstring是接收者(用户)的 openid

template_idstring是所需下发的订阅模板id

pagestring否点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转。

dataObject是模板内容，格式形如 { "key1": { "value": any }, "key2": { "value": any } }

返回值

Object

返回的 JSON 数据包

属性类型说明errcodenumber错误码

errmsgstring错误信息

errcode 的合法值

值说明最低版本40003touser字段openid为空或者不正确

40037订阅模板id为空不正确

43101用户拒绝接受消息，如果用户之前曾经订阅过，则表示用户取消了订阅关系

47003模板参数不准确，可能为空或者不满足规则，errmsg会提示具体是哪个字段出错

41030page路径不正确，需要保证在现网版本小程序中存在，与app.json保持一致

请求示例{

"touser":"OPENID",

"template_id":"TEMPLATE_ID",

"page":"index",

"data":{

"number01":{

"value":"339208499"

},

"date01":{

"value":"2015年01月05日"

},

"site01":{

"value":"TIT创意园"

},

"site02":{

"value":"广州市新港中路397号"

}

}

}

订阅消息参数值内容限制说明参数类别参数说明参数值限制说明thing.DATA事物20个以内字符可汉字、数字、字母或符号组合

number.DATA数字32位以内数字只能数字，可带小数

letter.DATA字母32位以内字母只能字母

symbol.DATA符号5位以内符号只能符号

character_string.DATA字符串32位以内数字、字母或符号可数字、字母或符号组合

time.DATA时间24小时制时间格式(支持+年月日)例如：15:01，或：2019年10月1日 15:01

date.DATA日期年月日格式(支持+24小时制时间)例如：2019年10月1日，或：2019年10月1日 15:01

amount.DATA金额1个币种符号+10位以内纯数字，可带小数，结尾可带“元”可带小数

phone_number.DATA电话17位以内，数字、符号电话号码，例：+86-0766-66888866

car_number.DATA车牌8位以内，第一位与最后一位可为汉字，其余为字母或数字车牌号码：粤A8Z888挂

name.DATA姓名10个以内纯汉字或20个以内纯字母或符号中文名10个汉字内；纯英文名20个字母内；中文和字母混合按中文名算，10个字内

phrase.DATA汉字5个以内汉字5个以内纯汉字，例如：配送中

符号表示除中文、英文、数字外的常见符号，不能带有换行等控制字符。时间格式支持HH:MM:SS或者HH:MM。日期包含年月日，为y年m月d日，y年m月、m月d日格式，或者用‘-’、‘/’、‘.’符号连接，如2018-01-01，2018/01/01，2018.01.01，2018-01，01-01。每个模板参数都会以类型为前缀，例如第一个数字模板参数为number01.DATA，第二个为number02.DATA

例如，模板的内容为

姓名:{{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"

}

}

}

云调用云调用是小程序·云开发提供的在云函数中调用微信开放接口的能力，需要在云函数中通过 wx-server-sdk 使用。

接口方法openapi.subscribeMessage.send

需在 config.json 中配置 subscribeMessage.send API 的权限，详情

请求参数属性类型默认值必填说明touserstring是接收者(用户)的 openid

templateIdstring是所需下发的订阅模板id

pagestring否点击模板卡片后的跳转页面，仅限本小程序内的页面。支持带参数,(示例index?foo=bar)。该字段不填则模板无跳转。

dataObject是模板内容，格式形如 { "key1": { "value": any }, "key2": { "value": any } }

返回值

Object

返回的 JSON 数据包

属性类型说明errCodenumber错误码

errMsgstring错误信息

errCode 的合法值

值说明最低版本0成功

异常

Object

抛出的异常

属性类型说明errCodenumber错误码

errMsgstring错误信息

errCode 的合法值

值说明最低版本40003touser字段openid为空或者不正确

40037订阅模板id为空不正确

43101用户拒绝接受消息，如果用户之前曾经订阅过，则表示用户取消了订阅关系

47003模板参数不准确，可能为空或者不满足规则，errmsg会提示具体是哪个字段出错

41030page路径不正确，需要保证在现网版本小程序中存在，与app.json保持一致

请求示例constcloud=require('wx-server-sdk')

cloud.init()

exports.main=async(event,context)=>{

try{

constresult=await cloud.openapi.subscribeMessage.send({

touser:'OPENID',

page:'index',

data:{

number01:{

value:'339208499'

},

date01:{

value:'2015年01月05日'

},

site01:{

value:'TIT创意园'

},

site02:{

value:'广州市新港中路397号'

}

},

templateId:'TEMPLATE_ID'

})

console.log(result)

returnresult

}catch(err){

console.log(err)

returnerr

}

}