為了滿(mǎn)足用戶(hù)渠道推廣分析和用戶(hù)賬號(hào)綁定等場(chǎng)景的需要，公眾平臺(tái)提供了生成帶參數(shù)二維碼的接口。使用該接口可以獲得多個(gè)帶不同場(chǎng)景值的二維碼，用戶(hù)掃描后，公眾號(hào)可以接收到事件推送。使用接口過(guò)程中有任何問(wèn)題，可以前往微信開(kāi)放社區(qū) #公眾號(hào) 專(zhuān)區(qū)發(fā)帖交流。

目前有2種類(lèi)型的二維碼：

1、臨時(shí)二維碼，是有過(guò)期時(shí)間的，最長(zhǎng)可以設(shè)置為在二維碼生成后的30天（即秒）后過(guò)期，但能夠生成較多數(shù)量。臨時(shí)二維碼主要用于賬號(hào)綁定等不要求二維碼永久保存的業(yè)務(wù)場(chǎng)景2、永久二維碼，是無(wú)過(guò)期時(shí)間的，但數(shù)量較少（目前為最多10萬(wàn)個(gè)）。永久二維碼主要用于適用于賬號(hào)綁定、用戶(hù)來(lái)源統(tǒng)計(jì)等場(chǎng)景。

用戶(hù)掃描帶場(chǎng)景值二維碼時(shí)，可能推送以下兩種事件：

如果用戶(hù)還未關(guān)注公眾號(hào)，則用戶(hù)可以關(guān)注公眾號(hào)，關(guān)注后微信會(huì)將帶場(chǎng)景值關(guān)注事件推送給開(kāi)發(fā)者。

如果用戶(hù)已經(jīng)關(guān)注公眾號(hào)推廣微信 公眾號(hào)，在用戶(hù)掃描后會(huì)自動(dòng)進(jìn)入會(huì)話(huà)推廣微信 公眾號(hào)，微信也會(huì)將帶場(chǎng)景值掃描事件推送給開(kāi)發(fā)者。

獲取帶參數(shù)的二維碼的過(guò)程包括兩步，首先創(chuàng)建二維碼，然后憑借到指定URL換取二維碼。

創(chuàng)建二維碼

每次創(chuàng)建二維碼需要提供一個(gè)開(kāi)發(fā)者自行設(shè)定的參數(shù)（），分別介紹臨時(shí)二維碼和永久二維碼的創(chuàng)建二維碼過(guò)程。

臨時(shí)二維碼請(qǐng)求說(shuō)明

http請(qǐng)求方式: : POST數(shù)據(jù)格式：數(shù)據(jù)例子：{"": , "": "", "": {"": {"": 123}}}或者也可以使用以下POST數(shù)據(jù)創(chuàng)建字符串形式的二維碼參數(shù)：{"": ,"": "", "": {"": {"": "test"}}}

永久二維碼請(qǐng)求說(shuō)明

http請(qǐng)求方式: : POST數(shù)據(jù)格式：數(shù)據(jù)例子：{"": "", "": {"": {"": 123}}}或者也可以使用以下POST數(shù)據(jù)創(chuàng)建字符串形式的二維碼參數(shù)：{"": "", "": {"": {"": "test"}}}

參數(shù)說(shuō)明

參數(shù) 說(shuō)明

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

二維碼類(lèi)型，為臨時(shí)的整型參數(shù)值，為臨時(shí)的字符串參數(shù)值，為永久的整型參數(shù)值，為永久的字符串參數(shù)值

二維碼詳細(xì)信息

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

場(chǎng)景值ID（字符串形式的ID），字符串類(lèi)型，長(zhǎng)度限制為1到64

返回說(shuō)明

正確的Json返回結(jié)果:

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

參數(shù) 說(shuō)明

獲取的二維碼，憑借此可以在有效時(shí)間內(nèi)換取二維碼。

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

url

二維碼圖片解析后的地址，開(kāi)發(fā)者可根據(jù)該地址自行生成需要的二維碼圖片

通過(guò)換取二維碼

獲取二維碼后，開(kāi)發(fā)者可用換取二維碼圖片。請(qǐng)注意推廣微信 公眾號(hào)，本接口無(wú)須登錄態(tài)即可調(diào)用。

請(qǐng)求說(shuō)明

HTTP GET請(qǐng)求（請(qǐng)使用協(xié)議）提醒：記得進(jìn)行

返回說(shuō)明

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

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

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