微信公众平台---带参数二维码生成和扫描事件
微信公众平台—带参数二维码生成和扫描事件
为了满足用户渠道推广分析和用户帐号绑定等场景的需要,公众平台提供了生成带参数二维码的接口。使用该接口可以获得多个带不同场景值的二维码,用户扫描后,公众号可以接收到事件推送。
目前有2种类型的二维码:
- 1、临时二维码,是有过期时间的,最长可以设置为在二维码生成后的30天(即2592000秒)后过期,但能够生成较多数量。临时二维码主要用于帐号绑定等不要求二维码永久保存的业务场景。
- 2、永久二维码,是无过期时间的,但数量较少(目前为最多10万个)。永久二维码主要用于适用于帐号绑定、用户来源统计等场景。
获取带参数的二维码的过程包括两步,首先创建二维码ticket,然后凭借ticket到指定URL换取二维码。
创建二维码ticket
每次创建二维码ticket需要提供一个开发者自行设定的参数(scene_id),分别介绍临时二维码和永久二维码的创建二维码ticket过程。
临时二维码请求说明:
- http请求方式: POST
- URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST数据格式:json
- POST数据例子:{"expire_seconds": 604800, "action_name": "QR_SCENE", "action_info": {"scene": {"scene_id": 123}}}
永久二维码请求说明:
- http请求方式: POST
- URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKENPOST数据格式: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": "123"}}}
返回参数说明:
永久二维码只返回ticket和url,临时二维码只返回ticket,expire_seconds和url
通过ticket换取二维码
获取二维码ticket后,开发者可用ticket换取二维码图片。请注意,本接口无须登录态即可调用。
请求说明
- HTTP GET请求(请使用https协议)https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET提醒:TICKET记得进行UrlEncode
示例代码:
- $vipLogic = D(\'Vip\',\'Logic\');
- $userinfo = session(\'userinfo\');
- $vip = $vipLogic->where(array(\'openid\'=>$userinfo[\'openid\']))->field(\'sceneid,id\')->find();
- $count = $vipLogic->where(array(\'sceneid\'=>array(\'neq\',0)))->count();
- $sceneid = $count+1; //设定场景值
- if($vip != null && $vip[\'sceneid\'] == 0){ //用户关注了该公众号 但是还未生成自己的二维码
- $data = array( //需要POST传输的数据
- \'action_name\' => \'QR_LIMIT_SCENE\',
- \'action_info\' => array(
- \'scene\' => array(
- \'scene_id\' => $sceneid,
- ),
- ),
- );
- $dir = \'./Public/Wechat/qrcode/\'.$userinfo[\'openid\'].\'.jpg\'; //二维码存放路径
- if(!file_exists($dir)){
- //二维码不存在 则生成二维码
- $ticket = $this -> getTicket($data);
- $vipLogic -> where(array(\'openid\'=>$userinfo[\'openid\'])) -> save(array(\'sceneid\'=>$sceneid));
- $url = \'https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=\'.$ticket[\'ticket\']; //通过ticket换取二维码
- $img = file_get_contents($url);
- $dir = \'./Public/Wechat/qrcode/\'.$userinfo[\'openid\'].\'.jpg\';
- if(!empty($img)){
- @file_put_contents($dir,$img);
- }
- }
- }
- public function getTicket($data){
- $access_token = $this -> getAccessToken();
- $url = \'https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=\'.$access_token;
- $res = $this -> httpdata($url, $data);
- return $res;
- }
- /**
- * http带参数请求
- * @date: 2015-1-31
- * @author: 明
- * @return:
- */
- public function httpdata($url,$data){
- $data = json_encode($data);
- $ch = curl_init();
- curl_setopt($ch, CURLOPT_URL, $url);
- curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
- curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, FALSE);
- curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, FALSE);
- curl_setopt($ch, CURLOPT_USERAGENT, \'Mozilla/5.0 (compatible; MSIE 5.01; Windows NT 5.0)\');
- curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1);
- curl_setopt($ch, CURLOPT_AUTOREFERER, 1);
- curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
- curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
- $status = curl_exec($ch);
- curl_close($ch);
- $res = json_decode($status,true);
- return $res;
- }
扫描带参数二维码事件
参数说明:
示例代码:在获取关注事件加入功能代码
- $key = explode(\'_\', $eventkey) ;
- if($key[1]!=null){
- //邀请我的人
- $vipLogic = D(\'Vip\',\'Logic\');
- $vip = $vipLogic->where(array(\'sceneid\'=>$key[1]))->field(\'id,openid\')->find();
- //我
- $openid = session(\'openid\');
- }