- 管理員登錄查看小程序APPID及祕鑰,調用wx.login() 方法獲取code備用。
- 獲取用戶openid接口地址:
參數說明如下:
appid |
是 |
小程序唯一標識 |
secret |
是 |
小程序的 app secret |
js_code |
是 |
登錄時獲取的 code |
grant_type |
是 |
填寫爲 authorization_code |
返回及說明:
在不滿足UnionID下發條件的情況下,返回參數:
openid |
用戶唯一標識 |
session_key |
會話密鑰 |
在滿足UnionID下發條件的情況下,返回參數:
openid |
用戶唯一標識 |
session_key |
會話密鑰 |
unionid |
用戶在開放平臺的唯一標識符 |
Unionid說明:
https://developers.weixin.qq.com/miniprogram/dev/api/unionID.html
- 獲取access_token接口地址:
https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
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"}
獲取access_token備用。
- 發送模板消息接口地址:
https://api.weixin.qq.com/cgi-bin/message/wxopen/template/send?access_token=ACCESS_TOKEN
HTTP請求方式:post
POST參數說明:
參數 |
必填 |
說明 |
touser |
是 |
接收者(用戶)的 openid |
template_id |
是 |
所需下發的模板消息的id |
page |
否 |
點擊模板卡片後的跳轉頁面,僅限本小程序內的頁面。支持帶參數,(示例index?foo=bar)。該字段不填則模板無跳轉。 |
form_id |
是 |
|
data |
是 |
模板內容,不填則下發空模板 |
color |
否 |
模板內容字體的顏色,不填默認黑色 【廢棄】 |
emphasis_keyword |
否 |
模板需要放大的關鍵詞,不填則默認無放大 |
返回碼說明:
在調用模板消息接口後,會返回JSON數據包。
正常時的返回JSON數據包示例:
{
"errcode": 0,
"errmsg": "ok"
}
錯誤時會返回錯誤碼信息,說明如下:
返回碼 |
說明 |
40037 |
template_id不正確 |
41028 |
form_id不正確,或者過期 |
41029 |
form_id已被使用 |
41030 |
page不正確 |
45009 |
接口調用超過限額(目前默認每個帳號日調用限額爲100萬) |
例:
{
"touser": "OPENID",
"template_id": "TEMPLATE_ID",
"page": "index",
"form_id": "FORMID",
"data": {
"keyword1": {
"value": "339208499"
},
"keyword2": {
"value": "2015年01月05日 12:30"
},
"keyword3": {
"value": "粵海喜來登酒店"
} ,
"keyword4": {
"value": "廣州市天河區天河路208號"
}
},
"emphasis_keyword": "keyword1.DATA"
}
推送的模板格式須管理員在已有的模板中挑選或申請模板。