微信公眾平臺(tái)開發(fā)(83) 生成帶參數(shù)二維碼

2019-11-15 01:27:37

字體：大中小

供稿：網(wǎng)友

本文介紹在微信公眾平臺(tái)上如何使用高級(jí)接口開發(fā)生成帶參數(shù)二維碼的功能。

一、場(chǎng)景二維碼

為了滿足用戶渠道推廣分析的需要，公眾平臺(tái)提供了生成帶參數(shù)二維碼的接口。使用該接口可以獲得多個(gè)帶不同場(chǎng)景值的二維碼，用戶掃描后，公眾號(hào)可以接收到事件推送。

目前有2種類型的二維碼，分別是臨時(shí)二維碼和永久二維碼，前者有過期時(shí)間，最大為1800秒，但能夠生成較多數(shù)量，后者無過期時(shí)間，數(shù)量較少（目前參數(shù)只支持1--100000）。兩種二維碼分別適用于帳號(hào)綁定、用戶來源統(tǒng)計(jì)等場(chǎng)景。

用戶掃描帶場(chǎng)景值二維碼時(shí)，可能推送以下兩種事件：

如果用戶還未關(guān)注公眾號(hào)，則用戶可以關(guān)注公眾號(hào)，關(guān)注后微信會(huì)將帶場(chǎng)景值關(guān)注事件推送給開發(fā)者。

如果用戶已經(jīng)關(guān)注公眾號(hào)，在用戶掃描后會(huì)自動(dòng)進(jìn)入會(huì)話，微信也會(huì)將帶場(chǎng)景值掃描事件推送給開發(fā)者。

獲取帶參數(shù)的二維碼的過程包括兩步，首先創(chuàng)建二維碼ticket，然后憑借ticket到指定URL換取二維碼。

二、創(chuàng)建二維碼ticket

每次創(chuàng)建二維碼ticket需要提供一個(gè)開發(fā)者自行設(shè)定的參數(shù)（scene_id），分別介紹臨時(shí)二維碼和永久二維碼的創(chuàng)建二維碼ticket過程。

臨時(shí)二維碼請(qǐng)求說明

http請(qǐng)求URL

https://api.weixin.QQ.com/cgi-bin/qrcode/create?access_token=TOKEN

POST數(shù)據(jù)格式

1 {2     "expire_seconds": 1800,3     "action_name": "QR_SCENE",4     "action_info": {5         "scene": {6             "scene_id": 1000007         }8     }9 }

返回格式：

{    "ticket": "gQFK8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL3kweXE0T3JscWY3UTltc3ZPMklvAAIEG9jUUgMECAcAAA==",    "expire_seconds": 1800}

永久二維碼請(qǐng)求說明

http請(qǐng)求URL

https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN

POST數(shù)據(jù)格式

{    "action_name": "QR_LIMIT_SCENE",    "action_info": {        "scene": {            "scene_id": 1000        }    }}

返回格式

{    "ticket": "gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA=="}

提交數(shù)據(jù)參數(shù)說明：

返回結(jié)果參數(shù)說明

程序?qū)崿F(xiàn)

三、通過ticket換取二維碼

獲取二維碼ticket后，開發(fā)者可用ticket換取二維碼圖片。無須登錄態(tài)即可調(diào)用。

HTTPS GET請(qǐng)求說明（TICKET必需UrlEncode）

https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET

ticket正確情況下，http 返回碼是200，是一張圖片，可以直接展示或者下載。

HTTP頭示例如下：

 1 { 2     "url": "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA%3D%3D", 3     "content_type": "image/jpg", 4     "http_code": 200, 5     "header_size": 162, 6     "request_size": 181, 7     "filetime": -1, 8     "ssl_verify_result": 20, 9     "redirect_count": 0,10     "total_time": 0.509,11     "namelookup_time": 0,12     "connect_time": 0.058,13     "下面是二種場(chǎng)景二維碼的URL及生成的圖片
https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQFK8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL3kweXE0T3JscWY3UTltc3ZPMklvAAIEG9jUUgMECAcAAA%3d%3d
https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA%3d%3d
四、下載二維碼二維碼生成以后，可以在瀏覽器中右鍵另存為本地圖片，但如果有很多二維碼的時(shí)候，用程序來下載就比較方便。
我們使用CURL獲取圖片的所有信息，并將圖片數(shù)據(jù)保存為一個(gè)文件。一個(gè)完整的下載代碼如下：
這樣，在程序當(dāng)前目錄就會(huì)生成一個(gè)包含二維碼的圖片文件。
五、掃描帶參數(shù)二維碼事件用戶掃描帶場(chǎng)景值二維碼時(shí)，可能推送以下兩種事件：
如果用戶還未關(guān)注公眾號(hào)，則用戶可以關(guān)注公眾號(hào)，關(guān)注后微信會(huì)將帶場(chǎng)景值關(guān)注事件推送給開發(fā)者。
如果用戶已經(jīng)關(guān)注公眾號(hào)，則微信會(huì)將帶場(chǎng)景值掃描事件推送給開發(fā)者。
1. 用戶未關(guān)注時(shí)，進(jìn)行關(guān)注后的事件推送<xml><ToUserName><![CDATA[gh_45072270791c]]></ToUserName><FromUserName><![CDATA[o7Lp5t6n59DeX3U0C7Kric9qEx-Q]]></FromUserName><CreateTime>1389684286</CreateTime><MsgType><![CDATA[event]]></MsgType><Event><![CDATA[subscribe]]></Event><EventKey><![CDATA[qrscene_1000]]></EventKey><Ticket><![CDATA[gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA==]]></Ticket></xml>
參數(shù)說明
2. 用戶已關(guān)注時(shí)的事件推送
<xml><ToUserName><![CDATA[gh_45072270791c]]></ToUserName><FromUserName><![CDATA[o7Lp5t6n59DeX3U0C7Kric9qEx-Q]]></FromUserName><CreateTime>1389684184</CreateTime><MsgType><![CDATA[event]]></MsgType><Event><![CDATA[SCAN]]></Event><EventKey><![CDATA[1000]]></EventKey><Ticket><![CDATA[gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA==]]></Ticket></xml>
參數(shù)說明
事件代碼：
以下代碼判定了掃描帶參數(shù)二維碼的兩種情形
private function receiveEvent($object){    $contentStr = "";    switch ($object->Event)    {        case "subscribe":            $contentStr = "歡迎關(guān)注方倍工作室 ";            if (isset($object->EventKey)){                $contentStr = "關(guān)注二維碼場(chǎng)景 ".$object->EventKey;            }            break;        case "SCAN":            $contentStr = "掃描 ".$object->EventKey;             //要實(shí)現(xiàn)統(tǒng)計(jì)分析，則需要掃描事件寫入數(shù)據(jù)庫(kù)，這里可以記錄 EventKey及用戶OpenID，掃描時(shí)間            break;        default:            break;           }    $resultStr = $this->transmitText($object, $contentStr);    return $resultStr;}
六、渠道統(tǒng)計(jì)分析后臺(tái)將獲得所有二維碼關(guān)注情況，數(shù)據(jù)如下所示：
對(duì)其進(jìn)行簡(jiǎn)單統(tǒng)計(jì)分析后，效果如圖
七、內(nèi)容更新及源碼下載本節(jié)最新的教程說明及源代碼已在《微信公眾平臺(tái)開發(fā)最佳實(shí)踐》一書中發(fā)布，歡迎購(gòu)買。
點(diǎn)此購(gòu)買《微信公眾平臺(tái)開發(fā)最佳實(shí)踐》