微信公眾平臺(tái)開發(fā)教程(六)獲取個(gè)性二維碼的實(shí)例
一、功能介紹
在進(jìn)行推廣時(shí),我們可以告訴對方,我們的微信公眾賬號(hào)是什么,客戶可以去搜索,然后關(guān)注。二維碼給我們提供了極大的便捷,只要簡單一掃描,即可關(guān)注。
如果已經(jīng)關(guān)注過,立刻跳入對話畫面。在我們進(jìn)行推廣時(shí),不再是簡陋的文字,可以是一個(gè)有個(gè)性的二維碼,想必會(huì)很生動(dòng)。
微信對二維碼提供了很好的支持,而且還可以根據(jù)需要生成不同場景的二維碼。下面我們將介紹如何獲取和使用二維碼。
注意:限服務(wù)號(hào),且進(jìn)行了微信認(rèn)證,費(fèi)用300

二、相關(guān)接口
為了滿足用戶渠道推廣分析的需要,公眾平臺(tái)提供了生成帶參數(shù)二維碼的接口。使用該接口可以獲得多個(gè)帶不同場景值的二維碼,用戶掃描后,公眾號(hào)可以接收到事件推送。
目前有2種類型的二維碼,分別是臨時(shí)二維碼和永久二維碼,前者有過期時(shí)間,最大為1800秒,但能夠生成較多數(shù)量,后者無過期時(shí)間,數(shù)量較少(目前參數(shù)只支持1--1000)。兩種二維碼分別適用于帳號(hào)綁定、用戶來源統(tǒng)計(jì)等場景。
用戶掃描帶場景值二維碼時(shí),可能推送以下兩種事件:
1.如果用戶還未關(guān)注公眾號(hào),則用戶可以關(guān)注公眾號(hào),關(guān)注后微信會(huì)將帶場景值關(guān)注事件推送給開發(fā)者。
2.如果用戶已經(jīng)關(guān)注公眾號(hào),在用戶掃描后會(huì)自動(dòng)進(jìn)入會(huì)話,微信也會(huì)將帶場景值掃描事件推送給開發(fā)者。
獲取帶參數(shù)的二維碼的過程包括兩步,首先創(chuàng)建二維碼ticket,然后憑借ticket到指定URL換取二維碼。
創(chuàng)建二維碼ticket
每次創(chuàng)建二維碼ticket需要提供一個(gè)開發(fā)者自行設(shè)定的參數(shù)(scene_id),分別介紹臨時(shí)二維碼和永久二維碼的創(chuàng)建二維碼ticket過程。
臨時(shí)二維碼請求說明
http請求方式: 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}}}
永久二維碼請求說明
http請求方式: 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 | 場景值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換取二維碼圖片。請注意,本接口無須登錄態(tài)即可調(diào)用。
請求說明
HTTP GET請求(請使用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ù)場景ID獲取ticket
/// </summary>
/// <param name="sceneID">場景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">場景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">場景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));
}
}
以上就是本文的全部內(nèi)容,希望對大家的學(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ì),對大家的學(xué)習(xí)或工作具有一定的參考借鑒價(jià)值,需要的朋友可以參考下2020-03-03
瀏覽器環(huán)境下JavaScript腳本加載與執(zhí)行探析之defer與async特性
defer和async特性相信是很多JavaScript開發(fā)者"熟悉而又不熟悉"的兩個(gè)特性,從字面上來看,二者的功能很好理解,分別是"延遲腳本"和"異步腳本"的作用2016-01-01
javaScript合并對象的多種方式及知識(shí)擴(kuò)展
眾所周知JavaScript中有多種方法可以合并對象,下面這篇文章主要給大家介紹了關(guān)于javaScript合并對象的多種方式及知識(shí)擴(kuò)展,文中通過實(shí)例代碼介紹的非常詳細(xì),需要的朋友可以參考下2023-02-02

