Force.com微信開發生成帶參數的二維碼

高洛峰
發布: 2017-03-03 09:56:03
原創
1658 人瀏覽過

為了滿足使用者管道推廣分析的需要,公眾平台提供了產生二維碼的介面。使用此介面可獲得多個不同場景值的二維碼,使用者掃描後,公眾號可以接收到事件推送。目前有兩種類型的二維碼,分別是臨時二維碼和永久二維碼,前者有過期時間,最大為1800秒,但能夠產生較多數量,後者無過期時間,數量較少(目前參數只支援1到100000)。兩種二維碼分別適用於帳號綁定、使用者來源統計等場景。

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

1. 如果用戶尚未關注公眾號,則使用者可以關注公眾號,關注後微信會將帶場景值關注事件推送給開發者(例如為特定活動準備的二維碼,與會者掃描後關注微信帳號,與此同時微信帳號可以將活動相關的訊息推送給用戶);

2. 如果用戶已經關注公眾號,在用戶掃描後會自動進入會話,微信也會將帶場景值掃描事件推送給開發者(上例同樣適用)。

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

 

建立二維碼ticket

每次都創建二維碼ticket需要提供一個開發者自行設定的參數(scene_id),分別介紹臨時二維碼和永久二維碼的創建二維碼ticket過程。

臨時二維碼請求說明:

#
 http请求方式: POST
 URL:  
 POST数据格式:json
 POST数据例子:{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
登入後複製

 

永久二維碼請求說明

 http请求方式: POST
 URL:  
 POST数据格式:json
 POST数据例子:{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}
登入後複製

 

請求JSON資料參數的具體說明如下:

Force.com微信開發生成帶參數的二維碼

正確的Json回傳結果範例如下:

#
{"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm3sUw==","expire_seconds":60,"url":"http:\/\/weixin.qq.com\/q\/kZgfwMTm72WWPkovabbI"}
登入後複製

 

傳回Json資料的格式說明如下:

Force.com微信開發生成帶參數的二維碼

#錯誤的Json回傳範例如下:

#
{"errcode":40013,"errmsg":"invalid appid"}
登入後複製

 

下面我們建構一個Visualforce Page來產生ticket。

Visualforce Page程式碼如下:

#
<page> 
   <form> 
      <font><strong>第一步,创建二维码Ticket</strong><br><br> 
      请输入授权AccessToken:<inputtext></inputtext><br><br> 
      <commandbutton></commandbutton><br> 
      </font> 
  </form> 
  {!msg} 
</page>
登入後複製

 

上面程式碼第4行放置了一個apex:inputText控件,相當於HTML的文字框,value的值指定了accessToken,這個必須是WeChatQRCodeGeneratorController類別裡一個有Getter Setter的公開屬性,如過該屬性有預設值則文字框會顯示這個預設值,如果使用者修改了文字方塊的內容,accessToken屬性的值也會自動改變。第5行放置了一個apex:commandButton控件,相當於HTML的按鈕,點擊這個按鈕將觸發action處指定的方法send。最後第8行直接顯示msg變量,該變數會用來顯示微信介面回傳的Json。畫面顯示效果如下:

Force.com微信開發生成帶參數的二維碼

 

#WeChatQRCodeGeneratorController類別的程式碼如下:

#
public class WeChatQRCodeGeneratorController { 
    public String msg { get; set; } 
    public String accessToken { get; set; } 
    public void send() { 
        Http h = new Http(); 
        HttpRequest req = new HttpRequest(); 
        req.setMethod('POST'); 
        req.setHeader('Accept-Encoding','gzip,deflate'); 
        req.setHeader('Content-Type','text/xml;charset=UTF-8'); 
        req.setHeader('User-Agent','Jakarta Commons-HttpClient/3.1'); 
        
        String json = '{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 12345}}}'; 
        
        req.setBody(json); 
        req.setEndpoint('https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=' + accessToken); 
        String bodyRes = ''; 
        
        try{ 
            HttpResponse res = h.send(req); 
            bodyRes = res.getBody(); 
        } 
        catch(System.CalloutException e) { 
            System.debug('Callout error: '+ e); 
            ApexPages.addMessage(new ApexPages.Message(ApexPages.Severity.FATAL, e.getMessage())); 
        } 
        msg = bodyRes; 
    }   
}
登入後複製

 

完成後儲存程式碼,輸入正確有效的Access Token,點選「產生建立二維碼Ticket」按鈕將會得到如下圖所示的用來換取二維碼的票據。其實回傳的json裡最後一個參數url的值就是二維碼的值,可以拿這個結果透過線上二維碼產生器產生二維碼:

Force.com微信開發生成帶參數的二維碼

 

通过ticket换取二维码

获取二维码ticket后,开发者可用ticket换取二维码图片,本接口无需登录即可调用,接口请求说明如下:

 HTTP GET请求(请使用https协议)
 https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET
登入後複製

 

返回说明:
登入後複製
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。

利用前面返回的票据调用该接口示例如下:

https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQH97zoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2YweHpqY1hrX255RGdnckl0V0otAAIENIwAVAMECAcAAA==
登入後複製

 更多Force.com微信開發生成帶參數的二維碼相关文章请关注PHP中文网!



相關標籤:
來源:php.cn
本網站聲明
本文內容由網友自願投稿,版權歸原作者所有。本站不承擔相應的法律責任。如發現涉嫌抄襲或侵權的內容,請聯絡admin@php.cn
最新問題
熱門教學
更多>
最新下載
更多>
網站特效
網站源碼
網站素材
前端模板
關於我們 免責聲明 Sitemap
PHP中文網:公益線上PHP培訓,幫助PHP學習者快速成長!