微平臺開發之生成帶引數二維碼
為了滿足使用者渠道推廣分析的需要,公眾平臺提供了生成帶引數二維碼的介面。使用該介面可以獲得多個帶不同場景值的二維碼,使用者掃描後,公眾號可以接收到事件推送。
目前有2種類型的二維碼,分別是臨時二維碼和永久二維碼,前者有過期時間,最大為1800秒,但能夠生成較多數量,後者無過期時間,數量較少(目前引數只支援1--100000)。兩種二維碼分別適用於帳號繫結、使用者來源統計等場景。
使用者掃描帶場景值二維碼時,可能推送以下兩種事件:
如果使用者還未關注公眾號,則使用者可以關注公眾號,關注後微信會將帶場景值關注事件推送給開發者。
如果使用者已經關注公眾號,在使用者掃描後會自動進入會話,微信也會將帶場景值掃描事件推送給開發者。
獲取帶引數的二維碼的過程包括兩步,首先建立二維碼ticket,然後憑藉ticket到指定URL換取二維碼。
二、建立二維碼ticket每次建立二維碼ticket需要提供一個開發者自行設定的引數(scene_id),分別介紹臨時二維碼和永久二維碼的建立二維碼ticket過程。
臨時二維碼請求說明
http請求URL
https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
POST資料格式
1 { 2 "expire_seconds": 1800, 3 "action_name": "QR_SCENE",4 "action_info": { 5 "scene": { 6 "scene_id": 100000 7 } 8 } 9 }
返回格式:
{ "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==" }
提交資料引數說明:
返回結果引數說明
程式實現
1 $access_token = " xDx0pD_ZvXkHM3oeu5oGjDt1_9HxlA-9g0vtR6MZ-v4r7MpvZYC4ee4OxN97Lr4irkPKE94tzBUhpZG_OvqAC3D3XaWJIGIn0eeIZnfaofO1C3LNzGphd_rEv3pIimsW9lO-4FOw6D44T3sNsQ5yXQ"; 2 3 //臨時 4 $qrcode = '{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 10000}}}'; 5 //永久 6 $qrcode = '{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 1000}}}'; 7 8 $url = "https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=$access_token"; 9 $result = https_post($url,$qrcode); 10 $jsoninfo = json_decode($result, true); 11 $ticket = $jsoninfo["ticket"]; 12 13 function https_post($url, $data = null){ 14 $curl = curl_init(); 15 curl_setopt($curl, CURLOPT_URL, $url); 16 curl_setopt($curl, CURLOPT_SSL_VERIFYPEER, FALSE); 17 curl_setopt($curl, CURLOPT_SSL_VERIFYHOST, FALSE); 18 if (!empty($data)){ 19 curl_setopt($curl, CURLOPT_POST, 1); 20 curl_setopt($curl, CURLOPT_POSTFIELDS, $data); 21 } 22 curl_setopt($curl, CURLOPT_RETURNTRANSFER, 1); 23 $output = curl_exec($curl); 24 curl_close($curl); 25 return $output; 26 }三、通過ticket換取二維碼
獲取二維碼ticket後,開發者可用ticket換取二維碼圖片。無須登入態即可呼叫。
HTTPS GET請求說明(TICKET必需UrlEncode)
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 "pretransfer_time": 0.343, 14 "size_upload": 0, 15 "size_download": 28497, 16 "speed_download": 55986, 17 "speed_upload": 0, 18 "download_content_length": 28497, 19 "upload_content_length": 0, 20 "starttransfer_time": 0.481, 21 "redirect_time": 0 22 }
下面是二種場景二維碼的URL及生成的圖片
四、下載二維碼
二維碼生成以後,可以在瀏覽器中右鍵另存為本地圖片,但如果有很多二維碼的時候,用程式來下載就比較方便。
我們使用CURL獲取圖片的所有資訊,並將圖片資料儲存為一個檔案。一個完整的下載程式碼如下:
$ticket = "gQHi8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0UweTNxNi1sdlA3RklyRnNKbUFvAAIELdnUUgMEAAAAAA=="; $url = "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=".urlencode($ticket); $imageInfo = downloadImageFromWeiXin($url); $filename = "qrcode.jpg"; $local_file = fopen($filename, 'w'); if (false !== $local_file){ if (false !== fwrite($local_file, $imageInfo["body"])) { fclose($local_file); } } function downloadImageFromWeiXin($url) { $ch = curl_init($url); curl_setopt($ch, CURLOPT_HEADER, 0); curl_setopt($ch, CURLOPT_NOBODY, 0); //只取body頭 curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE); curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $package = curl_exec($ch); $httpinfo = curl_getinfo($ch); curl_close($ch); return array_merge(array('body' => $package), array('header' => $httpinfo)); }
這樣,在程式當前目錄就會生成一個包含二維碼的圖片檔案。
五、掃描帶引數二維碼事件使用者掃描帶場景值二維碼時,可能推送以下兩種事件:
如果使用者還未關注公眾號,則使用者可以關注公眾號,關注後微信會將帶場景值關注事件推送給開發者。
如果使用者已經關注公眾號,則微信會將帶場景值掃描事件推送給開發者。
1. 使用者未關注時,進行關注後的事件推送
<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>
引數說明
2. 使用者已關注時的事件推送
<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>
引數說明
事件程式碼:
以下程式碼判定了掃描帶引數二維碼的兩種情形
private function receiveEvent($object)
{
$contentStr = "";
switch ($object->Event)
{
case "subscribe":
$contentStr = "歡迎關注 ";
if (isset($object->EventKey)){
$contentStr = "關注二維碼場景 ".$object->EventKey;
}
break;
case "SCAN":
$contentStr = "掃描 ".$object->EventKey;
break;
default:
break;
}
$resultStr = $this->transmitText($object, $contentStr);
return $resultStr;
}