DIV CSS 佈局教程網

微信公眾平台開發教程(六):取得帶參數的個性化二維碼
編輯:關於JavaScript     

一、功能說明

做推廣時,除了告訴對方公眾號名稱讓他們搜尋關注,更便利的方式是直接掃描二維碼。掃一下就進入關注流程,若已關注則直接跳進對話畫面。而且二維碼可以依場景產生不同版本,用在推廣文宣上更生動。

微信對二維碼支援得不錯,可以依需要產生不同場景值的碼。以下說明如何取得與使用。

注意:此功能限已微信認證的服務號。

二、相關介面

為了支援渠道推廣分析,公眾平台提供「生成帶參數二維碼」的介面,可以產生多個帶不同場景值的碼,使用者掃描後公眾號會收到事件推送。

二維碼分兩種:臨時碼有過期時間(最長 1800 秒),但數量上限寬鬆;永久碼不過期,但參數目前只支援 1~1000。兩者分別適合帳號綁定與用戶來源統計等情境。

使用者掃描帶場景值的二維碼時,會有兩種情況:尚未關注者,關注後微信會推送「帶場景值關注事件」;已關注者,掃描後自動進入會話,微信會推送「帶場景值掃描事件」。

整個流程分兩步:先建立二維碼 ticket,再用 ticket 換取二維碼圖片。

建立 ticket(臨時碼)

POST https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN

{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}

建立 ticket(永久碼)

POST https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN

{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}

參數說明:expire_seconds 為有效秒數,上限 1800;action_name 中 QR_SCENE 是臨時、QR_LIMIT_SCENE 是永久;scene_id 是場景值,臨時碼為 32 位整數,永久碼上限 1000。

成功回傳:

{"ticket":"gQG28DoAAAA...","expire_seconds":1800}

其中 ticket 用來後續換取圖片。失敗則回傳錯誤碼,例如 {"errcode":40013,"errmsg":"invalid appid"}。

用 ticket 換取二維碼

這個介面不需要登入態:

GET https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET

成功時 HTTP 狀態碼是 200,回應內容即為圖片(Content-Type: image/jpg),可直接顯示或下載;ticket 非法則回傳 404。

三、程式碼實作

仍延續先前的機器人專案,直接看程式碼:

public class DimensionalCodeManager {
    // 注意:字串中要輸出 { 必須寫成 {{,否則 string.Format 會報格式錯誤
    private const string TEMP_JSON_DATA =
        "{{\"expire_seconds\": 1800, \"action_name\": \"QR_SCENE\", \"action_info\": {{\"scene\": {{\"scene_id\": {0}}}}}}}";

    private const string PERMANENT_URL =
        "{{\"action_name\": \"QR_LIMIT_SCENE\", \"action_info\": {{\"scene\": {{\"scene_id\": {0}}}}}}}";

    private const string GET_TICKET_URL =
        "https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token={0}";

    private const string GET_CODE_URL =
        "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket={0}";

    /// 依場景 ID 取得 ticket
    private static string GetTicket(int sceneID, bool isTemp) {
        string data;
        if (isTemp) {
            data = string.Format(TEMP_JSON_DATA, sceneID.ToString());
        } else {
            if (sceneID > 0 && sceneID <= 1000) {
                data = string.Format(PERMANENT_URL, sceneID);
            } else {
                return null;   // 永久碼的 scene_id 範圍不合法
            }
        }

        string ticketJson = HttpUtility.GetData(string.Format(GET_TICKET_URL, Context.AccessToken));
        XDocument doc = XmlUtility.ParseJson(ticketJson, "root");
        XElement ticket = doc.Root?.Element("ticket");
        return ticket?.Value;
    }

    public static string GenerateTemp(int sceneID) {
        string ticket = GetTicket(sceneID, true);
        if (ticket == null) { return null; }
        return HttpUtility.GetData(string.Format(GET_CODE_URL, ticket));
    }

    public static string GeneratePermanent(int sceneID) {
        string ticket = GetTicket(sceneID, false);
        if (ticket == null) { return null; }
        return HttpUtility.GetData(string.Format(GET_CODE_URL, ticket));
    }
}

實作時有兩個容易忽略的點:一是永久碼的 scene_id 有 1~1000 的範圍限制,超出要自行擋掉;二是字串內要輸出單一大括號時,在 string.Format 裡必須寫成兩個。

XML學習教程| jQuery入門知識| AJAX入門| Dreamweaver教程| Fireworks入門知識| SEO技巧| SEO優化集錦|
Copyright © DIV+CSS佈局教程網 All Rights Reserved