微信公众平台—-带参数二维码生成和扫描事件

摘要: 账号管理----生成带参数的二维码 消息管理----接收消息----接收事件推送

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

目前有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

 

        返回说明

  ticket正确情况下,http 返回码是200,是一张图片,可以直接展示或者下载。

  错误情况下(如ticket非法)返回HTTP错误码404。

示例代码:

复制代码
$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;
    }
复制代码

 

扫描带参数二维码事件

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

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

1. 用户未关注时,进行关注后的事件推送

参数说明:

2. 用户已关注时的事件推送

参数说明:

 

示例代码:在获取关注事件加入功能代码

复制代码
$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');    
        }
复制代码

微信公众平台—-带参数二维码生成和扫描事件