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

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


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

<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_str。臨時二維碼也支持。將action_name改爲指定的QR_STR_SCENE就可以。我是實踐出來了

如果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
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章