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

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

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

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

  2. 

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

    3. 



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\');    
        }













							

   
版权声明：本文为jucheng原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。



本文链接：https://www.cnblogs.com/jucheng/p/6248746.html