高级接口--生成带参数二维码

官方文档

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

目前有2种类型的二维码：

1、临时二维码，是有过期时间的，最长可以设置为在二维码生成后的30天（即2592000秒）后过期，但能够生成较多数量。临时二维码主要用于帐号绑定等不要求二维码永久保存的业务场景

2、永久二维码，是无过期时间的，但数量较少（目前为最多10万个）。永久二维码主要用于适用于帐号绑定、用户来源统计等场景

获取带参数的二维码的过程包括两步，首先创建二维码ticket，然后凭借ticket到指定URL换取二维码

 

创建二维码ticket

每次创建二维码ticket需要提供一个开发者自行设定的参数(scene_id)。

def create_ticket(access_token,action_name='QR_SCENE',scene=1,expire_seconds=1800):
    postData ={'action_name': action_name}
    if type(scene) == str:
        postData['action_info'] ={'scene':{
            'scene_str':scene
        }}
    elif type(scene) == int:
        postData['action_info'] = {'scene': {
            'scene_id': scene
        }}
    else:
        raise ValueError('scene type must be str or int')
    if action_name == 'QR_SCENE':
        print('创建临时二维码ticket')
        postData['expire_seconds']=expire_seconds

    ticket_create_url = 'https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=%s'% access_token
    response = requests.post(ticket_create_url,json.dumps(postData))
    return json.loads(response.text)

 

通过ticket换取二维码

获取二维码ticket后，开发者可用ticket换取二维码图片。请注意，该操作无须授权或登录即可调用

def exchange_qrcode(ticket):
    exchange_url = 'https://mp.weixin.qq.com/cgi-bin/showqrcode'
    params = {
        'ticket':ticket
    }
    response = requests.get(exchange_url,params=params)
    with open('test.jpg','wb') as qrimg:
        qrimg.write(response.content)
    return response.headers

 

扫描带参数二维码事件：

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

如果用户还未关注公众号，则用户可以关注公众号，关注后微信会将带场景值关注事件推送给开发者。

b'<xml><ToUserName><![CDATA[gh_8cb4b2533af7]]></ToUserName>\n<FromUserName><![CDATA[o-TXmsiCVUNT0iDRRaiW8iTxhx4Q]]></FromUserName>\n<CreateTime>1576808203</CreateTime>\n<MsgType><![CDATA[event]]></MsgType>\
n<Event><![CDATA[subscribe]]></Event>\n<EventKey><![CDATA[qrscene_1]]></EventKey>\n<Ticket><![CDATA[gQFq8DwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyVGpjVWNJVlJiQ08xT3ZRWU50MUIAAgSXLfxdAwQIBwAA]]></Ticke
t>\n</xml>'

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

b'<xml><ToUserName><![CDATA[gh_8cb4b2533af7]]></ToUserName>\n<FromUserName><![CDATA[o-TXmsiCVUNT0iDRRaiW8iTxhx4Q]]></FromUserName>\n<CreateTime>1576808272</CreateTime>\n<MsgType><![CDATA[event]]></MsgType>\
n<Event><![CDATA[SCAN]]></Event>\n<EventKey><![CDATA[1]]></EventKey>\n<Ticket><![CDATA[gQFq8DwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyVGpjVWNJVlJiQ08xT3ZRWU50MUIAAgSXLfxdAwQIBwAA]]></Ticket>\n</xml>'

 

换取短二维码短链接

def convert_shorturl(access_token,ticket):
    params =urllib.parse.urlencode({
        'ticket': ticket
    })
    exchange_url = 'https://mp.weixin.qq.com/cgi-bin/showqrcode?%s' % params
    convert_url = 'https://api.weixin.qq.com/cgi-bin/shorturl?access_token=%s'%access_token
    convert_data={
     'action':'long2short',
     'long_url':exchange_url
    }
    response = requests.post(convert_url,json.dumps(convert_data))
    short_url = json.loads(response.text)['short_url']
    qr_response = requests.get(short_url)
    with open('qrcode.jpg', 'wb') as qrimg:
        qrimg.write(qr_response.content)
    return short_url