產生帶參數的二維碼
產生參數的二維碼
為了滿足使用者管道推廣分析和使用者帳號綁定等場景的需要，公眾平台提供了產生參數二維碼的接口。使用此介面可獲得多個不同場景值的二維碼，使用者掃描後，公眾號可以接收到事件推送。
目前有2種類型的二維碼：
1、臨時二維碼，是有過期時間的，最長可以設定為在二維碼產生後的30天（即2592000秒）後過期，但能產生較多數量。臨時二維碼主要用於帳號綁定等不要求二維碼永久保存的業務場景
2、永久二維碼，是無過期時間的，但數量較少（目前為最多10萬個）。永久二維碼主要用於適用於帳號綁定、使用者來源統計等場景。
用戶掃描帶場景值二維碼時，可能推送以下兩種事件：
如果用戶尚未關注公眾號，則用戶可以關注公眾號，關注後微信會將帶場景值關注事件推送給開發者。
如果使用者已經關注公眾號，在使用者掃描後會自動進入會話，微信也會將帶場景值掃描事件推送給開發者。
取得帶有參數的二維碼的過程包括兩步，首先建立二維碼ticket，然後憑藉ticket到指定URL換取二維碼。
建立二維碼ticket
每次建立二維碼ticket需要提供一個開發者自行設定的參數（scene_id），分別介紹臨時二維碼和永久二維碼的創建二維碼ticket過程。
暫時二維碼請求說明
http要求方式: POST
URL: https://api.weixin.qq.com/cgi -bin/qrcode/create?access_token=TOKENPOST資料格式：json
POST資料範例：{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": {"scene_id": 123}}}
永久二維碼請求說明
http要求方式: POST
URL: https://api.weixin.qq.com/cgi-bin/ qrcode/create?access_token=TOKENPOST資料格式：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"}}}
參數說明
| 參數 | 說明 |
|---|---|
| expire_seconds | 此二維碼有效時間，以秒為單位。最大不超過2592000（即30天），此欄位如果不填，則預設有效期為30秒。 |
| action_name | 二維碼類型，QR_SCENE為暫存,QR_LIMIT_SCENE為永久,QR_LIMIT_STR_SCENE為永久的字串參數值 |
返回說明
正確的Json回傳結果:
{"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3VRtN = =","expire_seconds":60,"url":"http:\/\/weixin.qq.com\/q\/kZgfwMTm72WWPkovabbI"}
#
| 參數 | 說明 |
|---|---|
| ticket | 所取得的二維碼ticket，憑藉此ticket可以在有效時間內換取二維碼。 |
| expire_seconds | 該二維碼有效時間，以秒為單位。最大不超過2592000（即30天）。 |
| url | 二維碼圖片解析後的位址，開發者可依該位址自行產生所需的二維碼圖片 |
透過ticket換取二維碼
取得二維碼ticket後，開發者可用ticket換取二維碼圖片。請注意，本介面無須登入態即可呼叫。
請求說明
HTTP GET請求（請使用https協定）https://mp.weixin.qq.com/cgi-bin/showqrcode? ticket=TICKET提醒：TICKET記得進行UrlEncode
返回說明
ticket正確情況下，http 回傳碼是200，是圖片，可以直接展示或下載。
HTTP頭（範例）如下：
Accept-Ranges:bytes
Cache-control:max-age=604800
Connection:keep-alive
Content-Length :28026
Content-Type:image/jpg
Date:Wed, 16 Oct 2013 06:37:10 GMT
Expires:Wed, 23 Oct 2013 14:37:10 0800
Server:nginx /1.4.1
錯誤情況下（如ticket非法）回傳HTTP錯誤碼404。
