摘要: 账号管理----生成带参数的二维码 消息管理----接收消息----接收事件推送
为了满足用户渠道推广分析和用户帐号绑定等场景的需要,公众平台提供了生成带参数二维码的接口。使用该接口可以获得多个带不同场景值的二维码,用户扫描后,公众号可以接收到事件推送。
目前有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. 用户已关注时的事件推送
参数说明:
示例代码:在获取关注事件加入功能代码
$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'); }