本文介紹在微信公眾平台上如何使用高級接口開發生成帶參數二維碼的功能。
為了滿足用戶渠道推廣分析的需要,公眾平台提供了生成帶參數二維碼的接口。使用該接口可以獲得多個帶不同場景值的二維碼,用戶掃描後,公眾號可以接收到事件推送。
目前有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數據格式
"expire_seconds": 1800 "action_name": "QR_SCENE" "action_info" "scene" "scene_id": 100000 }
返回格式:
"ticket": "gQFK8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL3kweXE0T3JscWY3UTltc3ZPMklvAAIEG9jUUgMECAcAAA==""expire_seconds": 1800
http請求URL
https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
POST數據格式
"action_name": "QR_LIMIT_SCENE""action_info""scene""scene_id": 1000
"ticket": "gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA=="
返回結果參數說明
程序實現
= " xDx0pD_ZvXkHM3oeu5oGjDt1_9HxlA-9g0vtR6MZ-v4r7MpvZYC4ee4OxN97Lr4irkPKE94tzBUhpZG_OvqAC3D3XaWJIGIn0eeIZnfaofO1C3LNzGphd_rEv3pIimsW9lO-4FOw6D44T3sNsQ5yXQ" = '{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 10000}}}' = '{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 1000}}}' = "https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=" = https_post(, = json_decode(, = ["ticket" https_post(, = = curl_setopt(, CURLOPT_URL, curl_setopt(, CURLOPT_SSL_VERIFYPEER, curl_setopt(, CURLOPT_SSL_VERIFYHOST, (!( curl_setopt(, CURLOPT_POST, 1 curl_setopt(, CURLOPT_POSTFIELDS, curl_setopt(, CURLOPT_RETURNTRANSFER, 1 = curl_exec( curl_close( }
獲取二維碼ticket後,開發者可用ticket換取二維碼圖片。無須登錄態即可調用。
HTTPS GET請求說明(TICKET必需UrlEncode)
https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET
ticket正確情況下,http 返回碼是200,是一張圖片,可以直接展示或者下載。
HTTP頭示例如下:
"url": "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA%3D%3D", "content_type": "image/jpg", "http_code": 200, "header_size": 162, "request_size": 181, "filetime": -1, "ssl_verify_result": 20, "redirect_count": 0, "total_time": 0.509, "namelookup_time": 0, "connect_time": 0.058, "pretransfer_time": 0.343, "size_upload": 0, "size_download": 28497, "speed_download": 55986, "speed_upload": 0, "download_content_length": 28497, "upload_content_length": 0, "starttransfer_time": 0.481, "redirect_time": 0 }
https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQFK8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL3kweXE0T3JscWY3UTltc3ZPMklvAAIEG9jUUgMECAcAAA%3d%3d
https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA%3d%3d
二維碼生成以後,可以在浏覽器中右鍵另存為本地圖片,但如果有很多二維碼的時候,用程序來下載就比較方便。
我們使用CURL獲取圖片的所有信息,並將圖片數據保存為一個文件。一個完整的下載代碼如下:
= "gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA==" = "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=".( = downloadImageFromWeiXin( = "qrcode.jpg" = (, 'w' ( !== ( !== (, ["body"( downloadImageFromWeiXin( = curl_init(, CURLOPT_HEADER, 0, CURLOPT_NOBODY, 0); curl_setopt(, CURLOPT_SSL_VERIFYPEER, , CURLOPT_SSL_VERIFYHOST, , CURLOPT_RETURNTRANSFER, 1 = curl_exec( = curl_getinfo( (('body' => ), ('header' =>
用戶掃描帶場景值二維碼時,可能推送以下兩種事件:
如果用戶還未關注公眾號,則用戶可以關注公眾號,關注後微信會將帶場景值關注事件推送給開發者。
如果用戶已經關注公眾號,則微信會將帶場景值掃描事件推送給開發者。
1. 用戶未關注時,進行關注後的事件推送
1389684286
2. 用戶已關注時的事件推送
1389684184
事件代碼:
以下代碼判定了掃描帶參數二維碼的兩種情形
====================================================================
方倍工作室微信公眾平台賬號關注方法:
1. 微信通訊錄-添加朋友-查找公眾號-搜索“方倍工作室”
2. 微信通訊錄-添加朋友-搜號碼-輸入“pondbaystudio”
3. 使用微信掃描下面的二維碼