建站
咨詢
售后
建站咨詢
新聞中心
這里有您想知道的互聯(lián)網營銷解決方案
創(chuàng)新互聯(lián)小程序教程：微信小程序send
uniformMessage.send
本接口應在服務器端調用，詳細說明參見 服務端API。
創(chuàng)新互聯(lián)是專業(yè)的周寧網站建設公司，周寧接單;提供網站設計制作、網站設計,網頁設計,網站設計,建網站,PHP網站建設等專業(yè)做網站服務;采用PHP框架,可快速的進行周寧網站開發(fā)網頁制作和功能擴展;專業(yè)做搜索引擎喜愛的網站,專業(yè)的做網站團隊,希望更多企業(yè)前來合作!
本接口支持 云調用。需開發(fā)者工具版本 >= 1.02.1904090（最新 穩(wěn)定版下載）
wx-server-sdk >= 0.4.0
下發(fā)小程序和公眾號統(tǒng)一的服務消息
調用方式：
- HTTPS 調用
- 云調用
HTTPS 調用
請求地址
POST https://api.weixin.qq.com/cgi-bin/message/wxopen/template/uniform_send?access_token=ACCESS_TOKEN
請求參數(shù)
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| access_token | string | 是 | 接口調用憑證 | |
| touser | string | 是 | 用戶openid，可以是小程序的openid，也可以是mp_template_msg.appid對應的公眾號的openid | |
| weapp_template_msg | Object | 否 | 小程序模板消息相關的信息，可以參考小程序模板消息接口; 有此節(jié)點則優(yōu)先發(fā)送小程序模板消息 | |
| mp_template_msg | Object | 是 | 公眾號模板消息相關的信息，可以參考公眾號模板消息接口；有此節(jié)點并且沒有weapp_template_msg節(jié)點時，發(fā)送公眾號模板消息 |
weapp_template_msg 的結構
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| template_id | string | 是 | 小程序模板ID | |
| page | string | 是 | 小程序頁面路徑 | |
| form_id | string | 是 | 小程序模板消息formid | |
| data | string | 是 | 小程序模板數(shù)據(jù) | |
| emphasis_keyword | string | 是 | 小程序模板放大關鍵詞 |
mp_template_msg 的結構
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| appid | string | 是 | 公眾號appid，要求與小程序有綁定且同主體 | |
| template_id | string | 是 | 公眾號模板id | |
| url | string | 是 | 公眾號模板消息所要跳轉的url | |
| miniprogram | string | 是 | 公眾號模板消息所要跳轉的小程序，小程序的必須與公眾號具有綁定關系 | |
| data | string | 是 | 公眾號模板消息的數(shù)據(jù) |
返回值
Object
返回的 JSON 數(shù)據(jù)包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errcode | number | 錯誤碼 |
| errmsg | string | 錯誤信息 |
錯誤
| 錯誤碼 | 錯誤信息 | 說明 |
|---|---|---|
| 40037 | 模板id不正確，weapp_template_msg.template_id或者mp_template_msg.template_id | |
| 41028 | weapp_template_msg.form_id過期或者不正確 | |
| 41029 | weapp_template_msg.form_id已被使用 | |
| 41030 | weapp_template_msg.page不正確 | |
| 45009 | 接口調用超過限額 | |
| 40003 | touser不是正確的openid | |
| 40013 | appid不正確，或者不符合綁定關系要求 |
請求數(shù)據(jù)示例
{
"touser":"OPENID",
"weapp_template_msg":{
"template_id":"TEMPLATE_ID",
"page":"page/page/index",
"form_id":"FORMID",
"data":{
"keyword1":{
"value":"339208499"
},
"keyword2":{
"value":"2015年01月05日 12:30"
},
"keyword3":{
"value":"騰訊微信總部"
},
"keyword4":{
"value":"廣州市海珠區(qū)新港中路397號"
}
},
"emphasis_keyword":"keyword1.DATA"
},
"mp_template_msg":{
"appid":"APPID ",
"template_id":"TEMPLATE_ID",
"url":"http://weixin.qq.com/download",
"miniprogram":{
"appid":"xiaochengxuappid12345",
"pagepath":"index?foo=bar"
},
"data":{
"first":{
"value":"恭喜你購買成功！",
"color":"#173177"
},
"keyword1":{
"value":"巧克力",
"color":"#173177"
},
"keyword2":{
"value":"39.8元",
"color":"#173177"
},
"keyword3":{
"value":"2014年9月22日",
"color":"#173177"
},
"remark":{
"value":"歡迎再次購買！",
"color":"#173177"
}
}
}
}
返回數(shù)據(jù)示例
{
"errcode": 0,
"errmsg": "ok"
}
云調用
云調用是小程序·云開發(fā)提供的在云函數(shù)中調用微信開放接口的能力，需要在云函數(shù)中通過 wx-server-sdk 使用。
接口方法
openapi.uniformMessage.send
需在 config.json 中配置 uniformMessage.send API 的權限， 詳情
請求參數(shù)
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| touser | string | 是 | 用戶openid，可以是小程序的openid，也可以是mp_template_msg.appid對應的公眾號的openid | |
| weappTemplateMsg | Object | 否 | 小程序模板消息相關的信息，可以參考小程序模板消息接口; 有此節(jié)點則優(yōu)先發(fā)送小程序模板消息 | |
| mpTemplateMsg | Object | 是 | 公眾號模板消息相關的信息，可以參考公眾號模板消息接口；有此節(jié)點并且沒有weapp_template_msg節(jié)點時，發(fā)送公眾號模板消息 |
weappTemplateMsg 的結構
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| templateId | string | 是 | 小程序模板ID | |
| page | string | 是 | 小程序頁面路徑 | |
| formId | string | 是 | 小程序模板消息formid | |
| data | string | 是 | 小程序模板數(shù)據(jù) | |
| emphasisKeyword | string | 是 | 小程序模板放大關鍵詞 |
mpTemplateMsg 的結構
| 屬性 | 類型 | 默認值 | 必填 | 說明 |
|---|---|---|---|---|
| appid | string | 是 | 公眾號appid，要求與小程序有綁定且同主體 | |
| templateId | string | 是 | 公眾號模板id | |
| url | string | 是 | 公眾號模板消息所要跳轉的url | |
| miniprogram | string | 是 | 公眾號模板消息所要跳轉的小程序，小程序的必須與公眾號具有綁定關系 | |
| data | string | 是 | 公眾號模板消息的數(shù)據(jù) |
返回值
Object
返回的 JSON 數(shù)據(jù)包
| 屬性 | 類型 | 說明 |
|---|---|---|
| errCode | number | 錯誤碼 |
| errMsg | string | 錯誤信息 |
異常
Object
拋出的異常
| 屬性 | 類型 | 說明 |
|---|---|---|
| errCode | number | 錯誤碼 |
| errMsg | string | 錯誤信息 |
errCode 的合法值
| 值 | 說明 | 最低版本 |
|---|
錯誤
| 錯誤碼 | 錯誤信息 | 說明 |
|---|---|---|
| 40037 | 模板id不正確，weapp_template_msg.template_id或者mp_template_msg.template_id | |
| 41028 | weapp_template_msg.form_id過期或者不正確 | |
| 41029 | weapp_template_msg.form_id已被使用 | |
| 41030 | weapp_template_msg.page不正確 | |
| 45009 | 接口調用超過限額 | |
| 40003 | touser不是正確的openid | |
| 40013 | appid不正確，或者不符合綁定關系要求 |
請求數(shù)據(jù)示例
const cloud = require('wx-server-sdk')
cloud.init()
exports.main = async (event, context) => {
try {
const result = await cloud.openapi.uniformMessage.send({
touser: 'OPENID',
weappTemplateMsg: {
page: 'page/page/index',
data: {
keyword1: {
value: '339208499'
},
keyword2: {
value: '2015年01月05日 12:30'
},
keyword3: {
value: '騰訊微信總部'
},
keyword4: {
value: '廣州市海珠區(qū)新港中路397號'
}
},
templateId: 'TEMPLATE_ID',
formId: 'FORMID',
emphasisKeyword: 'keyword1.DATA'
},
mpTemplateMsg: {
appid: 'APPID ',
url: 'http://weixin.qq.com/download',
miniprogram: {
appid: 'xiaochengxuappid12345',
pagepath: 'index?foo=bar'
},
data: {
first: {
value: '恭喜你購買成功！',
color: '#173177'
},
keyword1: {
value: '巧克力',
color: '#173177'
},
keyword2: {
value: '39.8元',
color: '#173177'
},
keyword3: {
value: '2014年9月22日',
color: '#173177'
},
remark: {
value: '歡迎再次購買！',
color: '#173177'
}
},
templateId: 'TEMPLATE_ID'
}
})
return result
} catch (err) {
return err
}
}
返回數(shù)據(jù)示例
{
"errCode": 0,
"errMsg": "openapi.uniformMessage.send:ok"
}本文標題：創(chuàng)新互聯(lián)小程序教程：微信小程序send
網頁地址：http://www.5511xx.com/article/dpscddj.html
