本文介紹在微信公衆平台上如何使用進階接口開發生成帶參數二維碼的功能。
為了滿足使用者管道推廣分析的需要,公衆平台提供了生成帶參數二維碼的接口。使用該接口可以獲得多個帶不同場景值的二維碼,使用者掃描後,公衆号可以接收到事件推送。
目前有2種類型的二維碼,分别是臨時二維碼和永久二維碼,前者有過期時間,最大為1800秒,但能夠生成較多數量,後者無過期時間,數量較少(目前參數隻支援1--100000)。兩種二維碼分别适用于帳号綁定、使用者來源統計等場景。
使用者掃描帶場景值二維碼時,可能推送以下兩種事件:
如果使用者還未關注公衆号,則使用者可以關注公衆号,關注後微信會将帶場景值關注事件推送給開發者。
如果使用者已經關注公衆号,在使用者掃描後會自動進入會話,微信也會将帶場景值掃描事件推送給開發者。
擷取帶參數的二維碼的過程包括兩步,首先建立二維碼ticket,然後憑借ticket到指定URL換取二維碼。
每次建立二維碼ticket需要提供一個開發者自行設定的參數(scene_id),分别介紹臨時二維碼和永久二維碼的建立二維碼ticket過程。
臨時二維碼請求說明
http請求URL
https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
POST資料格式
傳回格式:
永久二維碼請求說明
傳回格式
送出資料參數說明:

傳回結果參數說明
程式實作
擷取二維碼ticket後,開發者可用ticket換取二維碼圖檔。無須登入态即可調用。
HTTPS GET請求說明(TICKET必需UrlEncode)
<a href="https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET">https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET</a>
ticket正确情況下,http 傳回碼是200,是一張圖檔,可以直接展示或者下載下傳。
HTTP頭示例如下:
下面是二種場景二維碼的URL及生成的圖檔
<a href="https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQFK8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL3kweXE0T3JscWY3UTltc3ZPMklvAAIEG9jUUgMECAcAAA%3D%3D">https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQFK8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL3kweXE0T3JscWY3UTltc3ZPMklvAAIEG9jUUgMECAcAAA%3d%3d</a>
<a href="https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA%3D%3D">https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA%3d%3d</a>
二維碼生成以後,可以在浏覽器中右鍵另存為本地圖檔,但如果有很多二維碼的時候,用程式來下載下傳就比較友善。
我們使用CURL擷取圖檔的所有資訊,并将圖檔資料儲存為一個檔案。一個完整的下載下傳代碼如下:
這樣,在程式目前目錄就會生成一個包含二維碼的圖檔檔案。
如果使用者已經關注公衆号,則微信會将帶場景值掃描事件推送給開發者。
1. 使用者未關注時,進行關注後的事件推送
參數說明
2. 使用者已關注時的事件推送
事件代碼:
以下代碼判定了掃描帶參數二維碼的兩種情形
背景将獲得所有二維碼關注情況,資料如下所示:
對其進行簡單統計分析後,效果如圖
本節最新的教程說明及源代碼已在《微信公衆平台開發最佳實踐(第3版)》一書中釋出,歡迎購買。