为了满足用户渠道推广分析和用户帐号绑定等场景的需要 。
一.目前有2种类型的二维码:
1.创建二维码官网文档说明
每次创建二维码ticket需要提供一个开发者自行设定的参数(scene_id),分别介绍临时二维码和永久二维码的创建二维码ticket过程。
1.1 临时二维码请求说明
http请求方式:
POST URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
POST数据格式:json
POST数据例子:
{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
或者也可以使用以下POST数据创建字符串形式的二维码参数:
{"expire_seconds": 604800, "action_name": "QR_STR_SCENE", "action_info": {"scene": {"scene_str": "test"}}}
1.2 永久二维码请求说明
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}}}
或者也可以使用以下POST数据创建字符串形式的二维码参数:
{"action_name": "QR_LIMIT_STR_SCENE", "action_info": {"scene": {"scene_str": "test"}}}
1.3 参数说明
参数 | 说明 |
---|---|
expire_seconds | 该二维码有效时间,以秒为单位。 最大不超过2592000(即30天),此字段如果不填,则默认有效期为30秒。 |
action_name | 二维码类型,QR_SCENE为临时的整型参数值,QR_STR_SCENE为临时的字符串参数值,QR_LIMIT_SCENE为永久的整型参数值,QR_LIMIT_STR_SCENE为永久的字符串参数值 |
action_info | 二维码详细信息 |
scene_id | 场景值ID,临时二维码时为32位非0整型,永久二维码时最大值为100000(目前参数只支持1--100000) |
scene_str | 场景值ID(字符串形式的ID),字符串类型,长度限制为1到64 |
1.4 返回说明
正确的Json返回结果:
{
"ticket":"gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm3sUw==",
"expire_seconds":60,
"url":"http://weixin.qq.com/q/kZgfwMTm72WWPkovabbI"
}
参数 | 说明 |
---|---|
ticket | 获取的二维码ticket,凭借此ticket可以在有效时间内换取二维码。 |
expire_seconds | 该二维码有效时间,以秒为单位。 最大不超过2592000(即30天)。 |
url | 二维码图片解析后的地址,开发者可根据该地址自行生成需要的二维码图片 |
2.代码实现以上部分
通过官方文档理解,获取二维码的过程分为两步
2.1 获取创建二维码ticket
/**
* 获取带参数二维码的ticket
* @return
*/
public static String GetTicket(String appId,String appSecret) {
//1.获取token
String token=WXUtilsCenter.getAccessToken(appId,appSecret);
String url="https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token="+token;
//2.生成临时字符串二维码:有效期10分钟,二维码类型为字符串参数值
String data="{"expire_seconds": 600, "action_name": "QR_STR_SCENE", "action_info": {"scene": {"scene_str": "kds"}}}";
String result=HttpUtil.post(url, data);
String ticket=JSONObject.fromObject(result).getString("ticket");
return ticket;
}
2.2 通过ticket换取二维码
获取二维码ticket后,开发者可用ticket换取二维码图片。请注意,本接口无须登录态即可调用。
请求说明
HTTP GET请求(请使用https协议)
https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET
提醒:TICKET记得进行UrlEncode
/**
* 获取当前公众号的二维码
* @param response
*/
@RequestMapping("/getQrCode")
public void getQrCode(HttpServletResponse response) {
//1.拿到ticket
String ticket=utils.GetTicket(appId, appSecret);
//2.用ticket换取二维码
String imgUrl="https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket="+ticket;
try {
URL url = new URL(imgUrl);
HttpURLConnection httpUrl=(HttpURLConnection)url.openConnection();
httpUrl.connect();
httpUrl.getInputStream();
InputStream is=httpUrl.getInputStream();
BufferedImage image = ImageIO.read(is);
// 可通过输出流输出到页面
ImageIO.write(image, "png", response.getOutputStream());
} catch (Exception e) {
e.printStackTrace();
}
}
2.2 通过接口地址打开二维码:
http://ksweixin.free.idcfengye.com/weichat/wx/getQrCode
至此,二维码的获取工作就完成。