专业的短链接生成工具
链接域名
短网址有效期
微信二维码跳转小程序
更新时间:2025-4-28 17:48:18 作者:爱短链
要将微信二维码与小程序跳转结合,需通过微信官方API生成特定二维码,用户扫描后可直接打开小程序指定页面。以下是具体步骤和实现方法:
一、准备工作
获取小程序基础信息
登录https://mp.weixin.qq.com/
进入「开发」-「开发管理」-「开发设置」,记录:
AppID(小程序ID)
AppSecret(小程序密钥)
服务器准备
需具备后端服务(如Node.js/Python/Java等),用于调用微信API(因涉及敏感密钥操作,不可在前端直接调用)。
二、生成小程序二维码
微信提供两种二维码接口,根据需求选择:
1. 普通二维码(有限数量)
接口:GET https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN
特点:
每个二维码需单独生成,适合少量固定场景(如活动页面)。
最多生成10万个二维码。
参数示例:
json
{ | |
"path": "pages/index/index?id=123", // 小程序内路径(含参数) | |
"width": 430 // 二维码宽度(像素) | |
} |
2. 无限数量二维码
接口:POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN
特点:
通过scene参数传递唯一标识,适合海量场景(如商品溯源)。
需自行管理scene与业务数据的映射。
参数示例:
json
{ | |
"scene": "item_123", // 自定义参数(最大32字符) | |
"page": "pages/detail/detail", // 小程序页面路径 | |
"width": 430 | |
} |
三、开发流程
步骤1:获取Access Token
python
# Python示例 | |
import requests | |
appid = "YOUR_APPID" | |
appsecret = "YOUR_APPSECRET" | |
url = f"https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={appid}&secret={appsecret}" | |
response = requests.get(url).json() | |
access_token = response['access_token'] |
步骤2:调用二维码生成接口
python
# 生成无限数量二维码 | |
url = f"https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token={access_token}" | |
data = { | |
"scene": "item_123", | |
"page": "pages/detail/detail", | |
"width": 430 | |
} | |
response = requests.post(url, json=data).content | |
# 将二维码保存为文件 | |
with open("qrcode.png", "wb") as f: | |
f.write(response) |
步骤3:前端展示二维码
将生成的qrcode.png嵌入网页或小程序:
html
<img src="https://your-domain.com/qrcode.png" alt="小程序二维码"> |
四、用户扫码后逻辑
路径参数解析:在小程序页面onLoad生命周期中获取参数:
javascript
Page({ | |
onLoad(options) { | |
const { id } = options; // 普通二维码参数 | |
// 或通过scene参数解析(需先解码) | |
const scene = decodeURIComponent(options.scene); | |
} | |
}) |
业务处理:
根据参数加载对应数据(如商品详情、活动页面等)。
五、注意事项
域名备案:
确保服务器域名已在微信公众平台备案(「开发」-「开发管理」-「服务器域名」)。
二维码有效期:
普通二维码永久有效,无限二维码默认7天过期(需在接口中设置is_hyaline=1延长至永久)。
参数限制:
scene参数最大32字符,需自行设计编码规则(如Base64或分段拼接)。
测试方法:
使用微信开发者工具「扫码预览」功能,或真机调试。
六、扩展场景
动态生成二维码:结合数据库,根据用户行为实时生成带唯一标识的二维码(如分销链接)。
数据统计:在扫码后记录scene参数,追踪二维码的扫描量和转化率。
通过以上步骤,用户扫描二维码后可直接跳转至小程序指定页面,并携带业务参数,实现精准场景化运营。