第六章 微信小程序API 模板消息.pdf

微信⼩程序API 模板消息 基于微信的通知渠道，我们为开发者提供了可以⾼效触达⽤户的模板消息 ⼒，以便 实现服务的闭环并提供更佳的体验。 模板推送位置：服务通知 模板下发条件：⽤户本⼈在微信体系内与页⾯有交互⾏为后触发，详见下发条件说明 模板跳转 ⼒：点击查看详情仅 跳转下发模板的该帐号的各个页⾯ 使⽤说明 1. 获取模板id ​ 登录https://mp .weixin .qq .com获取模板，如果没有合适的模板，可以申请添加新模 板，审核通过后可使⽤，详见模板审核说明 1. 页⾯的form/组件，属性report-submit为true时，可以声明为需发模板 消息，此时点击按钮提交表单可以获取formId，⽤于发送模板消息。或者当 ⽤户完成⽀付⾏为，可以获取prepay_id⽤于发送模板消息。 2. 调⽤接⼜下发模板消息 （详见接⼜说明） 接⼜说明 1. 获取access_token ​ access_token是全局唯⼀接⼜调⽤凭据，开发者调⽤各接⼜时都需使⽤access_token ， 请妥善保存。access_token的存储⾄少要保留5 12个字符空间。access_token的有效期⽬ 前为2个⼩时，需定时刷新，重复获取将导致上次获取的access_token失效。 公众平台的API调⽤所需的access_token的使⽤及⽣成⽅式说明： 1. 为了保密appsecrect ，第三⽅需要⼀个access_token获取和刷新的中控服务器。⽽ 其他业务逻辑服务器所使⽤的access_token均来⾃于该中控服务器，不应该各⾃ 去刷新，否则会造成access_token覆盖⽽影响业务； 2. ⽬前access_token的有效期通过返回的expire_in来传达，⽬前是7200秒之内的 值。中控服务器需要根据这个有效时间提前去刷新新access_token 。在刷新过程 中，中控服务器对外输出的依然是⽼access_token ，此时公众平台后台会保证在 刷新短时间内，新⽼access_token都可⽤，这保证了第三⽅业务的平滑过渡； . access_token的有效时间可 会在未来有调整，所以中控服务器不仅需要内部定 时主动刷新，还需要提供被动刷新access_token的接⼜，这样便于业务服务器在 API调⽤获知access_token 已超时的情况下，可以触发access_token的刷新流程。 ​ 开发者可以使⽤AppID和AppSecret调⽤本接⼜来获取access_token 。AppID和 AppSecret可登录微信公众平台官⽹-设置-开发设置中获得 （需要已经绑定成为开发 者，且帐号没有异常状态）。AppSecret⽣成后请⾃⾏保存，因为在公众平台每次⽣成 查看都会导致AppSecret被重置。注意调⽤所有微信接⼜时均需使⽤https协议。如果第 三⽅不使⽤中控服务器，⽽是选择各个业务逻辑点各⾃去刷新access_token ，那么就可 会产⽣冲突，导致服务不稳定。 接⼜地址： /cgi-bin/token?grant_type client_credenti HTTP请求⽅式: GET 参数说明 : 参数 必填 说明 grant_type 是 获取access_token填写client_credential appid 是 第三⽅⽤户唯⼀凭证 secret 是 第三⽅⽤户唯⼀凭证密钥，即appsecret 返回参数说明： 正常情况下，微信会返回下述JSON数据包给开发者： {access_token:ACCESS_TOKEN,expires_in:7200} 参数 说明 access_token 获取到的凭证 expires_in 凭证有效时间，单位：秒 错误时微信会返回错误码等信息，JSON数据包⽰例如下 （该⽰例为AppID⽆效错 误）: {errcode:40013,errmsg:invalid appid} 2. 发 模板消息 接⼜地址：(ACCESS_TOKEN需换成上⽂获取到的access_token) /cgi-bin/message/wxopen/template/send?ac HTTP请求⽅式： POST POST参数说明：