微信生成帶參數(shù)的二維碼

2019-03-14 12:05 更新

生成帶參數(shù)的二維碼

公眾號二維碼

為了滿足用戶渠道推廣分析和用戶帳號綁定等場景的需要，公眾平臺提供了生成帶參數(shù)二維碼的接口。使用該接口可以獲得多個帶不同場景值的二維碼，用戶掃描后，公眾號可以接收到事件推送。

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

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

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

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

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

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

創(chuàng)建二維碼ticket

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

臨時二維碼請求說明

http請求方式: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST數(shù)據(jù)格式：json
POST數(shù)據(jù)例子：{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}

永久二維碼請求說明

http請求方式: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST數(shù)據(jù)格式：json
POST數(shù)據(jù)例子：{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}
或者也可以使用以下POST數(shù)據(jù)創(chuàng)建字符串形式的二維碼參數(shù)：
{"action_name": "QR_LIMIT_STR_SCENE", "action_info": {"scene": {"scene_str": "123"}}}

參數(shù)說明

參數(shù)說明
expire_seconds該二維碼有效時間，以秒為單位。 最大不超過2592000（即30天），此字段如果不填，則默認有效期為30秒。
action_name二維碼類型，QR_SCENE為臨時,QR_LIMIT_SCENE為永久,QR_LIMIT_STR_SCENE為永久的字符串參數(shù)值
action_info二維碼詳細信息
scene_id場景值ID，臨時二維碼時為32位非0整型，永久二維碼時最大值為100000（目前參數(shù)只支持1--100000）
scene_str場景值ID（字符串形式的ID），字符串類型，長度限制為1到64，僅永久二維碼支持此字段   


返回說明

正確的Json返回結果:

{"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm

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


參數(shù)說明
ticket獲取的二維碼ticket，憑借此ticket可以在有效時間內(nèi)換取二維碼。
expire_seconds該二維碼有效時間，以秒為單位。 最大不超過2592000（即30天）。
url二維碼圖片解析后的地址，開發(fā)者可根據(jù)該地址自行生成需要的二維碼圖片

通過ticket換取二維碼

獲取二維碼ticket后，開發(fā)者可用ticket換取二維碼圖片。請注意，本接口無須登錄態(tài)即可調用。

請求說明

HTTP GET請求（請使用https協(xié)議）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。


以上內(nèi)容是否對您有幫助：
在線筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號
微信公眾號

編程獅公眾號