微信公众平台开发教程(六)获取个性二维码的实例


Posted in Javascript onDecember 02, 2016

一、功能介绍

在进行推广时,我们可以告诉对方,我们的微信公众账号是什么,客户可以去搜索,然后关注。二维码给我们提供了极大的便捷,只要简单一扫描,即可关注。

如果已经关注过,立刻跳入对话画面。在我们进行推广时,不再是简陋的文字,可以是一个有个性的二维码,想必会很生动。

微信对二维码提供了很好的支持,而且还可以根据需要生成不同场景的二维码。下面我们将介绍如何获取和使用二维码。

注意:限服务号,且进行了微信认证,费用300

微信公众平台开发教程(六)获取个性二维码的实例

二、相关接口

为了满足用户渠道推广分析的需要,公众平台提供了生成带参数二维码的接口。使用该接口可以获得多个带不同场景值的二维码,用户扫描后,公众号可以接收到事件推送。

目前有2种类型的二维码,分别是临时二维码和永久二维码,前者有过期时间,最大为1800秒,但能够生成较多数量,后者无过期时间,数量较少(目前参数只支持1--1000)。两种二维码分别适用于帐号绑定、用户来源统计等场景。

用户扫描带场景值二维码时,可能推送以下两种事件:

1.如果用户还未关注公众号,则用户可以关注公众号,关注后微信会将带场景值关注事件推送给开发者。

2.如果用户已经关注公众号,在用户扫描后会自动进入会话,微信也会将带场景值扫描事件推送给开发者。

获取带参数的二维码的过程包括两步,首先创建二维码ticket,然后凭借ticket到指定URL换取二维码。

创建二维码ticket

每次创建二维码ticket需要提供一个开发者自行设定的参数(scene_id),分别介绍临时二维码和永久二维码的创建二维码ticket过程。

临时二维码请求说明

http请求方式: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
POST数据格式:json
POST数据例子:{"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数据格式:json
POST数据例子:{"action_name": "QR_LIMIT_SCENE", "action_info": {"scene": {"scene_id": 123}}}

参数说明

参数 说明
expire_seconds 该二维码有效时间,以秒为单位。 最大不超过1800。
action_name 二维码类型,QR_SCENE为临时,QR_LIMIT_SCENE为永久
action_info 二维码详细信息
scene_id 场景值ID,临时二维码时为32位整型,永久二维码时最大值为1000

返回说明

正确的Json返回结果:

{"ticket":"gQG28DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0FuWC1DNmZuVEhvMVp4NDNMRnNRAAIEesLvUQMECAcAAA==","expire_seconds":1800}

参数 说明
ticket 获取的二维码ticket,凭借此ticket可以在有效时间内换取二维码。
expire_seconds 二维码的有效时间,以秒为单位。最大不超过1800。

错误的Json返回示例:

{"errcode":40013,"errmsg":"invalid appid"}

全局返回码说明

使用网页调试工具调试该接口 

通过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。

三、具体实现

 依然基于之前的机器人案例进行功能添加,直接看代码。

/// <summary>
 /// 二维码管理者
 /// </summary>
 public class DimensionalCodeManager
 {
 /// <summary>
 /// 临时二维码地址
 /// </summary>
 /// 使用string.format时,报:字符串格式错误,因为其中有{
 //private const string TEMP_URL = "{\"expire_seconds\": 1800, \"action_name\": \"QR_SCENE\", \"action_info\": {\"scene\": {\"scene_id\": {0}}}}";
 /// <summary>
 /// 解决办法,将原有字符串中的一个{用两个{代替
 /// </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>
 /// 根据场景ID获取ticket
 /// </summary>
 /// <param name="sceneID">场景ID</param>
 /// <param name="isTemp">是否是临时二维码</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>
 /// 创建临时二维码
 /// </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>
 /// 创建临时二维码
 /// </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));
 }
 }

 以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持三水点靠木。

Javascript 相关文章推荐
JS实现图片翻书效果示例代码
Sep 09 Javascript
以JSON形式将JS中Array对象数组传至后台的方法
Jan 06 Javascript
javascript使用window.open提示“已经计划系统关机”的原因
Aug 15 Javascript
node.js中的path.resolve方法使用说明
Dec 08 Javascript
JavaScript实现将UPC转换成ISBN的方法
May 26 Javascript
JavaScript简单下拉菜单实例代码
Sep 07 Javascript
bootstrap table之通用方法( 时间控件,导出,动态下拉框, 表单验证 ,选中与获取信息)代码分享
Jan 24 Javascript
vue+webpack实现异步组件加载的方法
Feb 03 Javascript
基于jQuery实现无缝轮播与左右点击效果
May 13 jQuery
react native 原生模块桥接的简单说明小结
Feb 26 Javascript
vue+springboot+element+vue-resource实现文件上传教程
Oct 21 Javascript
Vue实现简单购物车功能
Dec 13 Vue.js
Bootstrap Modal对话框如何在关闭时触发事件
Dec 02 #Javascript
基于javascript实现按圆形排列DIV元素(一)
Dec 02 #Javascript
关于Function中的bind()示例详解
Dec 02 #Javascript
bootstrap模态框消失问题的解决方法
Dec 02 #Javascript
谈谈因Vue.js引发关于getter和setter的思考
Dec 02 #Javascript
jquery获取input type=text中的值的各种方式(总结)
Dec 02 #Javascript
vue.js入门(3)——详解组件通信
Dec 02 #Javascript
You might like
用Flash图形化数据(二)
2006/10/09 PHP
基于mysql的bbs设计(五)
2006/10/09 PHP
php获取字符串中各个字符出现次数的方法
2015/02/23 PHP
利用PHP脚本在Linux下用md5函数加密字符串的方法
2015/06/29 PHP
java模拟PHP的pack和unpack类
2016/04/13 PHP
PHP检测接口Traversable用法详解
2017/12/29 PHP
PHP 观察者模式深入理解与应用分析
2019/09/25 PHP
向fckeditor编辑器插入指定代码的方法
2007/05/25 Javascript
jquery简单瀑布流实现原理及ie8下测试代码
2013/01/23 Javascript
jQuery+CSS 半开折叠效果原理及代码(自写)
2013/03/04 Javascript
js动态移动滚动条至底部示例代码
2014/04/24 Javascript
比例尺、缩略图、平移缩放之百度地图添加控件方法
2015/08/03 Javascript
javascript中 try catch用法
2015/08/16 Javascript
用JS生成UUID的方法实例
2016/03/30 Javascript
JQuery异步加载PartialView的方法
2016/06/07 Javascript
利用Js的console对象,在控制台打印调式信息测试Js的实现
2016/11/26 Javascript
JavaScrpt判断一个数是否是质数的实例代码
2017/06/11 Javascript
微信小程序倒计时功能实例代码
2018/07/17 Javascript
JavaScript使用享元模式实现文件上传优化操作示例
2018/08/07 Javascript
vue动态设置img的src路径实例
2018/09/18 Javascript
python实现查找两个字符串中相同字符并输出的方法
2015/07/11 Python
Django框架下在URLconf中指定视图缓存的方法
2015/07/23 Python
对tensorflow 的模型保存和调用实例讲解
2018/07/28 Python
利用arcgis的python读取要素的X,Y方法
2018/12/22 Python
python使用adbapi实现MySQL数据库的异步存储
2019/03/19 Python
Python实现生成密码字典的方法示例
2019/09/02 Python
python设置代理和添加镜像源的方法
2020/02/14 Python
Pycharm插件(Grep Console)自定义规则输出颜色日志的方法
2020/05/27 Python
CSS3实现闪烁动画效果的方法
2015/02/09 HTML / CSS
写好自荐信需做到的5要点
2014/03/07 职场文书
工会换届选举方案
2014/05/21 职场文书
公司经理任命书
2014/06/05 职场文书
幼儿园感恩节活动方案
2014/10/06 职场文书
优秀共产党员事迹材料2016
2016/02/29 职场文书
Python中zipfile压缩包模块的使用
2021/05/14 Python
 Python 中 logging 模块使用详情
2022/03/03 Python