Python 使用微信扫一扫功能全解析

最新推荐文章于 2025-03-07 15:33:11 发布

爱搬砖的程序猿.

最新推荐文章于 2025-03-07 15:33:11 发布

阅读量792

点赞数 16

文章标签：微信

本文链接：https://blog.csdn.net/weixin_53673272/article/details/145701506

版权

一、引言

在如今的移动互联网时代，微信扫一扫功能凭借其便捷性，被广泛应用于各种场景，如扫码支付、添加好友、识别二维码信息等。对于 Python 开发者而言，若能在项目中集成微信扫一扫功能，将极大地提升用户体验和项目的实用性。本文将详细介绍如何利用 Python 实现与微信扫一扫功能的对接，让你在开发中轻松应用这一强大功能。

二、实现原理概述

要在 Python 中使用微信扫一扫功能，主要借助微信提供的 JS-SDK。JS-SDK 是微信公众平台为开发者提供的一系列接口，允许开发者在网页中调用微信的原生功能，包括扫一扫。Python 主要负责后端的签名生成、配置信息获取等操作，前端页面则使用 JavaScript 调用 JS-SDK 的扫一扫接口。

三、前期准备工作

3.1 微信公众号配置

注册并登录微信公众平台（微信公众平台）。
在 “公众号设置 - 功能设置” 中，填写 JS 接口安全域名。该域名必须是经过 ICP 备案的有效域名，用于保证前端页面可以安全地调用微信 JS-SDK。

3.2 获取必要信息

AppID：在微信公众平台的 “开发 - 基本配置” 中可以找到，它是公众号的唯一标识。
AppSecret：同样在 “开发 - 基本配置” 中获取，用于生成接口调用凭证，需妥善保管，避免泄露。

3.3 安装 Python 依赖库

我们需要使用 requests 库来发送 HTTP 请求，使用 hashlib 库进行签名计算。若尚未安装 requests 库，可以使用以下命令进行安装：

pip install requests

四、Python 后端实现

4.1 获取 access_token

access_token 是调用微信接口的全局唯一凭证，有效期为 2 小时,最好是存入Redis,过期后重新获取。以下是获取 access_token 的 Python 代码：

import requests

APPID = 'your_appid'
APPSECRET = 'your_appsecret'

def get_access_token():
    url = f'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={APPID}&secret={APPSECRET}'
    response = requests.get(url)
    result = response.json()
    if 'access_token' in result:
        return result['access_token']
    else:
        print(f"获取 access_token 失败，错误信息：{result}")
        return None

4.2 获取 jsapi_ticket

jsapi_ticket 是调用微信 JS-SDK 接口的临时票据，有效期同样为 2 小时，需要使用 access_token 来获取。代码如下：

def get_jsapi_ticket(access_token):
    url = f'https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token={access_token}&type=jsapi'
    response = requests.get(url)
    result = response.json()
    if result.get('errcode') == 0:
        return result.get('ticket')
    else:
        print(f"获取 jsapi_ticket 失败，错误信息：{result}")
        return None

4.3 生成签名

根据 jsapi_ticket、当前页面的 URL 等信息生成签名，用于前端页面调用 JS-SDK 时的验证。代码如下：

import hashlib
import random
import string
import time

def generate_signature(jsapi_ticket, url):
    noncestr = ''.join(random.choices(string.ascii_letters + string.digits, k=16))
    timestamp = str(int(time.time()))
    sign_str = f'jsapi_ticket={jsapi_ticket}&noncestr={noncestr}&timestamp={timestamp}&url={url}'
    signature = hashlib.sha1(sign_str.encode('utf-8')).hexdigest()
    return {
        'appId': APPID,
        'nonceStr': noncestr,
        'timestamp': timestamp,
        'signature': signature
    }

4.4 完整后端示例代码

import requests
import hashlib
import random
import string
import time

APPID = 'your_appid'
APPSECRET = 'your_appsecret'

def get_access_token():
    url = f'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={APPID}&secret={APPSECRET}'
    response = requests.get(url)
    result = response.json()
    if 'access_token' in result:
        return result['access_token']
    else:
        print(f"获取 access_token 失败，错误信息：{result}")
        return None

def get_jsapi_ticket(access_token):
    url = f'https://api.weixin.qq.com/cgi-bin/ticket/getticket?access_token={access_token}&type=jsapi'
    response = requests.get(url)
    result = response.json()
    if result.get('errcode') == 0:
        return result.get('ticket')
    else:
        print(f"获取 jsapi_ticket 失败，错误信息：{result}")
        return None

def generate_signature(jsapi_ticket, url):
    noncestr = ''.join(random.choices(string.ascii_letters + string.digits, k=16))
    timestamp = str(int(time.time()))
    sign_str = f'jsapi_ticket={jsapi_ticket}&noncestr={noncestr}&timestamp={timestamp}&url={url}'
    signature = hashlib.sha1(sign_str.encode('utf-8')).hexdigest()
    return {
        'appId': APPID,
        'nonceStr': noncestr,
        'timestamp': timestamp,
        'signature': signature
    }

# 示例调用
if __name__ == "__main__":
    access_token = get_access_token()
    if access_token:
        jsapi_ticket = get_jsapi_ticket(access_token)
        if jsapi_ticket:
            current_url = 'https://yourdomain.com/yourpage'  # 当前页面的 URL
            signature_info = generate_signature(jsapi_ticket, current_url)
            print(signature_info)

五、前端页面实现

5.1 引入微信 JS-SDK

在 HTML 页面中引入微信 JS-SDK 的脚本文件：

<!DOCTYPE html>
<html lang="en">

<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>微信扫一扫示例</title>
    <script src="https://res.wx.qq.com/open/js/jweixin-1.6.0.js"></script>
</head>

<body>
    <button id="scan-btn">点击扫码</button>
    <script>
        // 从后端获取签名信息
        const signatureInfo = {
            appId: 'your_appid',
            nonceStr: 'your_noncestr',
            timestamp: 'your_timestamp',
            signature: 'your_signature'
        };

        // 配置微信 JS-SDK
        wx.config({
            debug: false, // 开启调试模式，会在控制台输出调试信息
            appId: signatureInfo.appId,
            timestamp: signatureInfo.timestamp,
            nonceStr: signatureInfo.nonceStr,
            signature: signatureInfo.signature,
            jsApiList: ['scanQRCode'] // 需要使用的 JS 接口列表，这里只需要扫一扫功能
        });

        wx.ready(function () {
            document.getElementById('scan-btn').addEventListener('click', function () {
                wx.scanQRCode({
                    needResult: 1, // 0 表示直接跳转到扫码结果页面，1 表示返回扫码结果
                    scanType: ["qrCode", "barCode"], // 可以扫二维码、条形码
                    success: function (res) {
                        var result = res.resultStr; // 扫码返回的结果
                        alert('扫码结果：' + result);
                    },
                    fail: function (err) {
                        alert('扫码失败：' + JSON.stringify(err));
                    }
                });
            });
        });

        wx.error(function (res) {
            alert('微信 JS-SDK 配置失败：' + JSON.stringify(res));
        });
    </script>
</body>

</html>