微信開發生成帶參數的二維碼的講解


在微信公眾號平台開發者那里,在“賬號管理”那里,有一項功能是“生成帶參數的二維碼”,通過這兒生成的二維碼,只要通過微信掃一掃之后,會把事件自動推送到微信公眾號上


用微信掃一掃推送到開發者網址那兒的數據如下:

<xml><ToUserName><![CDATA[gh_452****b0f2]]></ToUserName>
<FromUserName><![CDATA[oz1fVs4d****7FmFrCbc57o]]></FromUserName>
<CreateTime>1429416610</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[SCAN]]></Event>
<EventKey><![CDATA[155120hzw]]></EventKey>
<Ticket><![CDATA[gQH17zoAAAAAAAAAASxodHR****S9xL28waUNrM1BsV1ZJZ0VJcE8tbUFMAAIEcCozVQMEAAAAAA==]]></Ticket>
</xml>


可以看出是一個xmlstk格式的數據,Event里SCAN表示掃描,EventKey是生成二維碼時在json設置的數值,EventKey是可以自己指定的,其它都是微信平台內定的。。。通過自定義EventKey的數據,可以做到自動回復指定的數據


比如:我要做一個猜謎的游戲,每個猜謎都有一個唯一的編號,這個編號可以設置為EventKey值,然后別人掃描帶參數的二維碼時,會把謎語的編號(EventKey)傳遞過來,然后根據編號自動回復謎底給用戶。。。。即做拿出微信掃一掃就知道謎底。



更多的應用場景請自由發揮,比如:掃一掃,領取紅包等功能也是可以實現的。


微信官方開發文檔:

為了滿足用戶渠道推廣分析的需要,公眾平台提供了生成帶參數二維碼的接口。使用該接口可以獲得多個帶不同場景值的二維碼,用戶掃描后,公眾號可以接收到事件推送。
 
目前有2種類型的二維碼,分別是臨時二維碼和永久二維碼,前者有過期時間,最大為1800秒,但能夠生成較多數量,后者無過期時間,數量較少(目前參數只支持1--100000)。兩種二維碼分別適用於帳號綁定、用戶來源統計等場景。
 
用戶掃描帶場景值二維碼時,可能推送以下兩種事件:
 
如果用戶還未關注公眾號,則用戶可以關注公眾號,關注后微信會將帶場景值關注事件推送給開發者。
如果用戶已經關注公眾號,在用戶掃描后會自動進入會話,微信也會將帶場景值掃描事件推送給開發者。
獲取帶參數的二維碼的過程包括兩步,首先創建二維碼ticket,然后憑借ticket到指定URL換取二維碼。



ticket 單詞的意思我查了一下百度字典,表示“票、入場券”的意思,即通過入場券來換取二維碼。

換取的時候,其實就是把ticket加到URL的最后面,即xxxx.com/xxx.php?ticket=xxxx的形式

真實的效果如下:




 


其中ticket=xxx  后面的就是獲取到的ticket數值。




微信官方文檔如下:

每次創建二維碼ticket需要提供一個開發者自行設定的參數(scene_id),分別介紹臨時二維碼和永久二維碼的創建二維碼ticket過程。


scene_id最大值是10萬,請求的方式為post,被請求的網址都是一樣的。


POST數據格式:json
POST數據例子:{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}




expire_seconds表示過期的秒數,如果含有這個參數,表示臨時的二維碼,即長3分鍾后過期。


永久二維碼的請求示例:

POST數據格式:json
POST數據例子:{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}
或者也可以使用以下POST數據創建字符串形式的二維碼參數:
{"action_name": "QR_LIMIT_STR_SCENE", "action_info": {"scene": {"scene_str": "123"}}}



這里要注意一下,scene_str表求字符串,即推送的數據中EventKey的值是字符串,字符串要加雙引號,可以發送英文字符。


如果scene_id永久二維碼最大值是10萬,只能是數字,不要加雙引號


還有請求是post,數據格式為json


參數說明

參數 說明
expire_seconds 該二維碼有效時間,以秒為單位。 最大不超過1800。
action_name 二維碼類型,QR_SCENE為臨時,QR_LIMIT_SCENE為永久,QR_LIMIT_STR_SCENE為永久的字符串參數值
action_info 二維碼詳細信息
scene_id 場景值ID,臨時二維碼時為32位非0整型,永久二維碼時最大值為100000(目前參數只支持1--100000)
scene_str 場景值ID(字符串形式的ID),字符串類型,長度限制為1到64,僅永久二維碼支持此字段

返回說明

正確的Json返回結果:

{"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm3sUw==","expire_seconds":60,"url":"http:\/\/weixin.qq.com\/q\/kZgfwMTm72WWPkovabbI"}
參數 說明
ticket 獲取的二維碼ticket,憑借此ticket可以在有效時間內換取二維碼。
expire_seconds 二維碼的有效時間,以秒為單位。最大不超過1800。
url 二維碼圖片解析后的地址,開發者可根據該地址自行生成需要的二維碼圖片

錯誤的Json返回示例:

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

通過ticket換取二維碼

獲取二維碼ticket后,開發者可用ticket換取二維碼圖片。請注意,本接口無須登錄態即可調用。

提醒:TICKET記得進行UrlEncode


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM