1、準(zhǔn)備工作

微信公眾號(hào):AppId和APPSecret(必須認(rèn)證)
微信小程序:AppId和APPSecret(必須認(rèn)證)
微信開(kāi)放者平臺(tái)（小程序和公眾號(hào)必須綁定同一個(gè)開(kāi)放者平臺(tái)，必須認(rèn)證）

2、獲取微信公眾號(hào)的access_token(7200秒有效)

接口調(diào)用請(qǐng)求說(shuō)明

https請(qǐng)求方式: GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET

參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明grant_type是獲取access_token填寫(xiě)client_credentialappid是第三方用戶唯一憑證secret是第三方用戶唯一憑證密鑰，即appsecret

返回說(shuō)明

正常情況下，微信會(huì)返回下述JSON數(shù)據(jù)包給公眾號(hào)：

{"access_token":"ACCESS_TOKEN","expires_in":7200}

參數(shù)說(shuō)明

參數(shù)說(shuō)明access_token獲取到的憑證expires_in憑證有效時(shí)間，單位：秒

錯(cuò)誤時(shí)微信會(huì)返回錯(cuò)誤碼等信息，JSON數(shù)據(jù)包示例如下（該示例為AppID無(wú)效錯(cuò)誤）:

{"errcode":40013,"errmsg":"invalid appid"}

3、獲取微信公眾號(hào)的openID

1）header跳轉(zhuǎn)授權(quán)

"https://open.weixin.qq.com/connect/oauth2/authorize?appid={$this->appid}&redirect_uri={$callback}&response_type=code&scope=snsapi_userinfo&state={$state}#wechat_redirect";

用戶同意授權(quán)，獲取code

在確保微信公眾賬號(hào)擁有授權(quán)作用域（scope參數(shù)）的權(quán)限的前提下（服務(wù)號(hào)獲得高級(jí)接口后，默認(rèn)擁有scope參數(shù)中的snsapi_base和snsapi_userinfo），引導(dǎo)關(guān)注者打開(kāi)如下頁(yè)面：

https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect 若提示“該鏈接無(wú)法訪問(wèn)”，請(qǐng)檢查參數(shù)是否填寫(xiě)錯(cuò)誤，是否擁有scope參數(shù)對(duì)應(yīng)的授權(quán)作用域權(quán)限。

尤其注意：由于授權(quán)操作安全等級(jí)較高，所以在發(fā)起授權(quán)請(qǐng)求時(shí)，微信會(huì)對(duì)授權(quán)鏈接做正則強(qiáng)匹配校驗(yàn)，如果鏈接的參數(shù)順序不對(duì)，授權(quán)頁(yè)面將無(wú)法正常訪問(wèn)

參考鏈接(請(qǐng)?jiān)谖⑿趴蛻舳酥写蜷_(kāi)此鏈接體驗(yàn)):

scope為snsapi_base

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wx520c15f417810387&redirect_uri=https%3A%2F%2Fchong.qq.com%2Fphp%2Findex.php%3Fd%3D%26c%3DwxAdapter%26m%3DmobileDeal%26showwxpaytitle%3D1%26vb2ctag%3D4_2030_5_1194_60&response_type=code&scope=snsapi_base&state=123#wechat_redirect

scope為snsapi_userinfo

https://open.weixin.qq.com/connect/oauth2/authorize?appid=wxf0e81c3bee622d60&redirect_uri=http%3A%2F%2Fnba.bluewebgame.com%2Foauth_response.php&response_type=code&scope=snsapi_userinfo&state=STATE#wechat_redirect

尤其注意：跳轉(zhuǎn)回調(diào)redirect_uri，應(yīng)當(dāng)使用https鏈接來(lái)確保授權(quán)code的安全性。

參數(shù)說(shuō)明

參數(shù)是否必須說(shuō)明appid是公眾號(hào)的唯一標(biāo)識(shí)redirect_uri是授權(quán)后重定向的回調(diào)鏈接地址， 請(qǐng)使用 urlEncode 對(duì)鏈接進(jìn)行處理response_type是返回類型，請(qǐng)?zhí)顚?xiě)codescope是應(yīng)用授權(quán)作用域，snsapi_base （不彈出授權(quán)頁(yè)面，直接跳轉(zhuǎn)，只能獲取用戶openid），snsapi_userinfo （彈出授權(quán)頁(yè)面，可通過(guò)openid拿到昵稱、性別、所在地。并且， 即使在未關(guān)注的情況下，只要用戶授權(quán)，也能獲取其信息 ）state否重定向后會(huì)帶上state參數(shù)，開(kāi)發(fā)者可以填寫(xiě)a-zA-Z0-9的參數(shù)值，最多128字節(jié)#wechat_redirect是無(wú)論直接打開(kāi)還是做頁(yè)面302重定向時(shí)候，必須帶此參數(shù)

下圖為scope等于snsapi_userinfo時(shí)的授權(quán)頁(yè)面：

用戶同意授權(quán)后

如果用戶同意授權(quán)，頁(yè)面將跳轉(zhuǎn)至 redirect_uri/?code=CODE&state=STATE。

code說(shuō)明 ： code作為換取access_token的票據(jù)，每次用戶授權(quán)帶上的code將不一樣，code只能使用一次，5分鐘未被使用自動(dòng)過(guò)期。

首先請(qǐng)注意，這里通過(guò)code換取的是一個(gè)特殊的網(wǎng)頁(yè)授權(quán)access_token,與基礎(chǔ)支持中的access_token（該access_token用于調(diào)用其他接口）不同。公眾號(hào)可通過(guò)下述接口來(lái)獲取網(wǎng)頁(yè)授權(quán)access_token。如果網(wǎng)頁(yè)授權(quán)的作用域?yàn)閟nsapi_base，則本步驟中獲取到網(wǎng)頁(yè)授權(quán)access_token的同時(shí)，也獲取到了openid，snsapi_base式的網(wǎng)頁(yè)授權(quán)流程即到此為止。

4、發(fā)送模板消息

接口調(diào)用請(qǐng)求說(shuō)明

http請(qǐng)求方式: POST https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN

POST數(shù)據(jù)說(shuō)明

POST數(shù)據(jù)示例如下：

      {
           "touser":"OPENID",
           "template_id":"ngqIpbwh8bUfcSsECmogfXcV14J0tQlEpBO27izEYtY",
           "url":"http://weixin.qq.com/download",  
           "miniprogram":{
             "appid":"xiaochengxuappid12345",
             "pagepath":"index?foo=bar"
           },          
           "data":{
                   "first": {
                       "value":"恭喜你購(gòu)買(mǎi)成功！",
                       "color":"#173177"
                   },
                   "keyword1":{
                       "value":"巧克力",
                       "color":"#173177"
                   },
                   "keyword2": {
                       "value":"39.8元",
                       "color":"#173177"
                   },
                   "keyword3": {
                       "value":"2014年9月22日",
                       "color":"#173177"
                   },
                   "remark":{
                       "value":"歡迎再次購(gòu)買(mǎi)！",
                       "color":"#173177"
                   }
           }
       }

參數(shù)說(shuō)明

參數(shù)是否必填說(shuō)明touser是接收者openidtemplate_id是模板IDurl否模板跳轉(zhuǎn)鏈接（海外帳號(hào)沒(méi)有跳轉(zhuǎn)能力）miniprogram否跳小程序所需數(shù)據(jù)，不需跳小程序可不用傳該數(shù)據(jù)appid是所需跳轉(zhuǎn)到的小程序appid（該小程序appid必須與發(fā)模板消息的公眾號(hào)是綁定關(guān)聯(lián)關(guān)系，暫不支持小游戲）pagepath否所需跳轉(zhuǎn)到小程序的具體頁(yè)面路徑，支持帶參數(shù),（示例index?foo=bar），要求該小程序已發(fā)布，暫不支持小游戲data是模板數(shù)據(jù)color否模板內(nèi)容字體顏色，不填默認(rèn)為黑色

注意：openID為公眾號(hào)的openID