為了滿足用戶渠道推廣分析和用戶賬號綁定等場景的需要，公眾平臺提供了生成帶參數二維碼的接口。使用該接口可以獲得多個帶不同場景值的二維碼，用戶掃描后，公眾號可以接收到事件推送。使用接口過程中有任何問題，可以前往微信開放社區 #公眾號 專區發帖交流。

目前有2種類型的二維碼：

1、臨時二維碼，是有過期時間的，最長可以設置為在二維碼生成后的30天（即秒）后過期，但能夠生成較多數量。臨時二維碼主要用于賬號綁定等不要求二維碼永久保存的業務場景2、永久二維碼，是無過期時間的，但數量較少（目前為最多10萬個）。永久二維碼主要用于適用于賬號綁定、用戶來源統計等場景。

用戶掃描帶場景值二維碼時，可能推送以下兩種事件：

如果用戶還未關注公眾號，則用戶可以關注公眾號，關注后微信會將帶場景值關注事件推送給開發者。

如果用戶已經關注公眾號推廣微信 公眾號，在用戶掃描后會自動進入會話推廣微信 公眾號，微信也會將帶場景值掃描事件推送給開發者。

獲取帶參數的二維碼的過程包括兩步，首先創建二維碼，然后憑借到指定URL換取二維碼。

創建二維碼

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

臨時二維碼請求說明

http請求方式: : POST數據格式：數據例子：{"": , "": "", "": {"": {"": 123}}}或者也可以使用以下POST數據創建字符串形式的二維碼參數：{"": ,"": "", "": {"": {"": "test"}}}

永久二維碼請求說明

http請求方式: : POST數據格式：數據例子：{"": "", "": {"": {"": 123}}}或者也可以使用以下POST數據創建字符串形式的二維碼參數：{"": "", "": {"": {"": "test"}}}

參數說明

參數 說明

該二維碼有效時間，以秒為單位。 最大不超過（即30天），此字段如果不填，則默認有效期為60秒。

二維碼類型，為臨時的整型參數值，為臨時的字符串參數值，為永久的整型參數值，為永久的字符串參數值

二維碼詳細信息

場景值ID，臨時二維碼時為32位非0整型，永久二維碼時最大值為（目前參數只支持1--）

場景值ID（字符串形式的ID），字符串類型，長度限制為1到64

返回說明

正確的Json返回結果:

{"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm
3sUw==","expire_seconds":60,"url":"http://weixin.qq.com/q/kZgfwMTm72WWPkovabbI"}

參數 說明

獲取的二維碼，憑借此可以在有效時間內換取二維碼。

該二維碼有效時間，以秒為單位。 最大不超過（即30天）。

url

二維碼圖片解析后的地址，開發者可根據該地址自行生成需要的二維碼圖片

通過換取二維碼

獲取二維碼后，開發者可用換取二維碼圖片。請注意推廣微信 公眾號，本接口無須登錄態即可調用。

請求說明

HTTP GET請求（請使用協議）提醒：記得進行

返回說明

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

HTTP頭（示例）如下：-:-:max-age=:keep--:-Type:/:Wed, 16 Oct 2013 06:37:10 :Wed, 23 Oct 2013 14:37:10 +:/1.4.1

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