產生帶參數的二維碼

標籤：style   http   使用   os   io   strong   資料   for   

為了滿足使用者渠道推廣分析的需要，公眾平台提供了產生帶參數二維碼的介面。使用該介面可以獲得多個帶不同情境值的二維碼，使用者掃描後，公眾號可以接收到事件推送。

目前有2種類型的二維碼，分別是臨時二維碼和永久二維碼，前者有到期時間，最大為1800秒，但能夠產生較多數量，後者無到期時間，數量較少（目前參數只支援1--100000）。兩種二維碼分別適用於帳號綁定、使用者來源統計等情境。

使用者掃描帶情境值二維碼時，可能推送以下兩種事件：

1. 如果使用者還未關注公眾號，則使用者可以關注公眾號，關注後會將帶情境值關注事件推送給開發人員。
2. 如果使用者已經關注公眾號，在使用者掃描後會自動進入會話，也會將帶情境值掃描事件推送給開發人員。

擷取帶參數的二維碼的過程包括兩步，首先建立二維碼ticket，然後憑藉ticket到指定URL換取二維碼。

建立二維碼ticket

每次建立二維碼ticket需要提供一個開發人員自行設定的參數（scene_id），分別介紹臨時二維碼和永久二維碼的建立二維碼ticket過程。

臨時二維碼請求說明

http請求方式: POSTURL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST資料格式：jsonPOST資料例子：{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}

永久二維碼請求說明

http請求方式: POSTURL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST資料格式：jsonPOST資料例子：{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}

參數說明

參數	說明
expire_seconds	該二維碼有效時間，以秒為單位。 最大不超過1800。
action_name	二維碼類型，QR_SCENE為臨時,QR_LIMIT_SCENE為永久
action_info	二維碼詳細資料
scene_id	情境值ID，臨時二維碼時為32位非0整型，永久二維碼時最大值為100000（目前參數只支援1--100000）

返回說明

正確的Json返回結果:

{"ticket":"gQG28DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0FuWC1DNmZuVEhvMVp4NDNMRnNRAAIEesLvUQMECAcAAA==","expire_seconds":1800}

參數	說明
ticket	擷取的二維碼ticket，憑藉此ticket可以在有效時間內換取二維碼。
expire_seconds	二維碼的有效時間，以秒為單位。最大不超過1800。

錯誤的Json返回樣本:

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

全域返回碼說明

使用網頁調試工具調試該介面

通過ticket換取二維碼

擷取二維碼ticket後，開發人員可用ticket換取二維碼圖片。請注意，本介面無須登入態即可調用。

請求說明

HTTP GET請求（請使用https協議）https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET提醒：TICKET記得進行UrlEncode

返回說明

ticket正確情況下，http 返回碼是200，是一張圖片，可以直接展示或者下載。

HTTP頭（樣本）如下：Accept-Ranges:bytesCache-control:max-age=604800Connection:keep-aliveContent-Length:28026Content-Type:image/jpgDate:Wed, 16 Oct 2013 06:37:10 GMTExpires:Wed, 23 Oct 2013 14:37:10 +0800Server:nginx/1.4.1

錯誤情況下（如ticket非法）返回HTTP錯誤碼404。

使用網頁調試工具調試該介面