微信公眾平臺(tái)開發(fā)教程(六)獲取個(gè)性二維碼的實(shí)例
一、功能介紹
在進(jìn)行推廣時(shí),我們可以告訴對(duì)方,我們的微信公眾賬號(hào)是什么,客戶可以去搜索,然后關(guān)注。二維碼給我們提供了極大的便捷,只要簡(jiǎn)單一掃描,即可關(guān)注。
如果已經(jīng)關(guān)注過,立刻跳入對(duì)話畫面。在我們進(jìn)行推廣時(shí),不再是簡(jiǎn)陋的文字,可以是一個(gè)有個(gè)性的二維碼,想必會(huì)很生動(dòng)。
微信對(duì)二維碼提供了很好的支持,而且還可以根據(jù)需要生成不同場(chǎng)景的二維碼。下面我們將介紹如何獲取和使用二維碼。
注意:限服務(wù)號(hào),且進(jìn)行了微信認(rèn)證,費(fèi)用300
二、相關(guān)接口
為了滿足用戶渠道推廣分析的需要,公眾平臺(tái)提供了生成帶參數(shù)二維碼的接口。使用該接口可以獲得多個(gè)帶不同場(chǎng)景值的二維碼,用戶掃描后,公眾號(hào)可以接收到事件推送。
目前有2種類型的二維碼,分別是臨時(shí)二維碼和永久二維碼,前者有過期時(shí)間,最大為1800秒,但能夠生成較多數(shù)量,后者無過期時(shí)間,數(shù)量較少(目前參數(shù)只支持1--1000)。兩種二維碼分別適用于帳號(hào)綁定、用戶來源統(tǒng)計(jì)等場(chǎng)景。
用戶掃描帶場(chǎng)景值二維碼時(shí),可能推送以下兩種事件:
1.如果用戶還未關(guān)注公眾號(hào),則用戶可以關(guān)注公眾號(hào),關(guān)注后微信會(huì)將帶場(chǎng)景值關(guān)注事件推送給開發(fā)者。
2.如果用戶已經(jīng)關(guān)注公眾號(hào),在用戶掃描后會(huì)自動(dòng)進(jìn)入會(huì)話,微信也會(huì)將帶場(chǎng)景值掃描事件推送給開發(fā)者。
獲取帶參數(shù)的二維碼的過程包括兩步,首先創(chuàng)建二維碼ticket,然后憑借ticket到指定URL換取二維碼。
創(chuàng)建二維碼ticket
每次創(chuàng)建二維碼ticket需要提供一個(gè)開發(fā)者自行設(shè)定的參數(shù)(scene_id),分別介紹臨時(shí)二維碼和永久二維碼的創(chuàng)建二維碼ticket過程。
臨時(shí)二維碼請(qǐng)求說明
http請(qǐng)求方式: POST URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN POST數(shù)據(jù)格式:json POST數(shù)據(jù)例子:{"expire_seconds": 1800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
永久二維碼請(qǐng)求說明
http請(qǐng)求方式: POST URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN POST數(shù)據(jù)格式:json POST數(shù)據(jù)例子:{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}
參數(shù)說明
參數(shù) | 說明 |
---|---|
expire_seconds | 該二維碼有效時(shí)間,以秒為單位。 最大不超過1800。 |
action_name | 二維碼類型,QR_SCENE為臨時(shí),QR_LIMIT_SCENE為永久 |
action_info | 二維碼詳細(xì)信息 |
scene_id | 場(chǎng)景值ID,臨時(shí)二維碼時(shí)為32位整型,永久二維碼時(shí)最大值為1000 |
返回說明
正確的Json返回結(jié)果:
{"ticket":"gQG28DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0FuWC1DNmZuVEhvMVp4NDNMRnNRAAIEesLvUQMECAcAAA==","expire_seconds":1800}
參數(shù) | 說明 |
---|---|
ticket | 獲取的二維碼ticket,憑借此ticket可以在有效時(shí)間內(nèi)換取二維碼。 |
expire_seconds | 二維碼的有效時(shí)間,以秒為單位。最大不超過1800。 |
錯(cuò)誤的Json返回示例:
{"errcode":40013,"errmsg":"invalid appid"}
使用網(wǎng)頁調(diào)試工具調(diào)試該接口
通過ticket換取二維碼
獲取二維碼ticket后,開發(fā)者可用ticket換取二維碼圖片。請(qǐng)注意,本接口無須登錄態(tài)即可調(diào)用。
請(qǐng)求說明
HTTP GET請(qǐng)求(請(qǐng)使用https協(xié)議)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
錯(cuò)誤情況下(如ticket非法)返回HTTP錯(cuò)誤碼404。
三、具體實(shí)現(xiàn)
依然基于之前的機(jī)器人案例進(jìn)行功能添加,直接看代碼。
/// <summary> /// 二維碼管理者 /// </summary> public class DimensionalCodeManager { /// <summary> /// 臨時(shí)二維碼地址 /// </summary> /// 使用string.format時(shí),報(bào):字符串格式錯(cuò)誤,因?yàn)槠渲杏衶 //private const string TEMP_URL = "{\"expire_seconds\": 1800, \"action_name\": \"QR_SCENE\", \"action_info\": {\"scene\": {\"scene_id\": {0}}}}"; /// <summary> /// 解決辦法,將原有字符串中的一個(gè){用兩個(gè){代替 /// </summary> private const string TEMP_JSON_DATA = "{{\"expire_seconds\": 1800, \"action_name\": \"QR_SCENE\", \"action_info\": {{\"scene\": {{\"scene_id\": {0}}}}}}}"; /// <summary> /// 永久二維碼地址 /// </summary> private const string PERMANENT_URL = "{{\"action_name\": \"QR_LIMIT_SCENE\", \"action_info\": {{\"scene\": {{\"scene_id\": {0}}}}}}}"; /// <summary> /// 獲取ticket的URL /// </summary> private const string GET_TICKET_URL = " https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token={0}"; /// <summary> /// 獲取二維碼URL /// </summary> private const string GET_CODE_URL = "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket={0}"; /// <summary> /// 根據(jù)場(chǎng)景ID獲取ticket /// </summary> /// <param name="sceneID">場(chǎng)景ID</param> /// <param name="isTemp">是否是臨時(shí)二維碼</param> /// <returns></returns> private static string GetTicket(int sceneID, bool isTemp) { string result = null; string data = string.Empty; if (isTemp) { data = string.Format(TEMP_JSON_DATA, sceneID.ToString()); } else { if (sceneID > 0 && sceneID <= 1000) { data = string.Format(PERMANENT_URL, sceneID); } else { //scene_id不合法 return null; } } string ticketJson = HttpUtility.GetData(string.Format(GET_TICKET_URL,Context.AccessToken)); XDocument doc = XmlUtility.ParseJson(ticketJson, "root"); XElement root = doc.Root; if (root != null) { XElement ticket = root.Element("ticket"); if (ticket != null) { result = ticket.Value; } } return result; } /// <summary> /// 創(chuàng)建臨時(shí)二維碼 /// </summary> /// <param name="sceneID">場(chǎng)景id,int類型</param> /// <returns></returns> 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)); } /// <summary> /// 創(chuàng)建臨時(shí)二維碼 /// </summary> /// <param name="sceneID">場(chǎng)景id,int類型</param> /// <returns></returns> 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)); } }
以上就是本文的全部?jī)?nèi)容,希望對(duì)大家的學(xué)習(xí)有所幫助,也希望大家多多支持腳本之家。
相關(guān)文章
javascript表格隔行變色加鼠標(biāo)移入移出及點(diǎn)擊效果的方法
這篇文章主要介紹了javascript表格隔行變色加鼠標(biāo)移入移出及點(diǎn)擊效果的方法,涉及javascript實(shí)現(xiàn)隔行變色及鼠標(biāo)點(diǎn)擊效果的相關(guān)技巧,非常具有實(shí)用價(jià)值,需要的朋友可以參考下2015-04-04微信小程序scroll-view隱藏滾動(dòng)條的方法詳解
這篇文章主要介紹了微信小程序scroll-view隱藏滾動(dòng)條的方法,本文通過實(shí)例代碼給大家介紹的非常詳細(xì),對(duì)大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-03-03瀏覽器環(huán)境下JavaScript腳本加載與執(zhí)行探析之defer與async特性
defer和async特性相信是很多JavaScript開發(fā)者"熟悉而又不熟悉"的兩個(gè)特性,從字面上來看,二者的功能很好理解,分別是"延遲腳本"和"異步腳本"的作用2016-01-01JavaScript常用對(duì)象的方法和屬性小結(jié)
JavaScript是基于對(duì)象的語言。我們知道,對(duì)象是由一組數(shù)據(jù)(JavaScript中稱之為屬性)和施加在這組數(shù)據(jù)上的方法組成的。JavaScript中還有一些不屬于任何對(duì)象的系統(tǒng)函數(shù)2012-01-01javaScript合并對(duì)象的多種方式及知識(shí)擴(kuò)展
眾所周知JavaScript中有多種方法可以合并對(duì)象,下面這篇文章主要給大家介紹了關(guān)于javaScript合并對(duì)象的多種方式及知識(shí)擴(kuò)展,文中通過實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下2023-02-02