让每一次扫码都成为一次优雅的抵达
——「快缩短网址」× 微信小程序二维码全链路指南

在信息洪流中，我们希望用户只需一次抬手，便能精准落入你预设的「掌心」。借助微信官方能力，「快缩短网址」（suo.run）将冗长的「扫码→搜索→点击」压缩为「扫码→直达」。以下方案，助你以最小代价，完成最高效的闭环。

一、前置准备：三把钥匙
1. 小程序身份
登录 mp.weixin.qq.com →「开发」→「开发设置」
抄录：
• AppID（身份）
• AppSecret（密钥）

2. 服务器
任何可运行 Node / Python / Java 的后端皆可。切记：密钥绝不可暴露于前端。

3. 域名白名单
在「服务器域名」中登记你的 API 域名，备案不可省。

二、二维码形态：二选一
| 类型 | 接口 | 数量上限 | 适用场景 |
|---|---|---|---|
| 精致码 | /wxa/getwxacode | 10 万 | 活动海报、固定入口 |
| 无限码 | /wxa/getwxacodeunlimit | 无上限 | 商品溯源、千人千面 |

三、实战：后端三步曲
（以下示例以 Python 为例，Node/Java 同理）

Step 1 换取 Access Token

python

import requests

APPID  = '你的 AppID'

SECRET = '你的 AppSecret'

token_url = f'https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={APPID}&secret={SECRET}'

token = requests.get(token_url).json()['access_token']

python

qr_url = f'https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token={token}'

payload = {

    "scene": "item_123",            # 32 字符内，可自定义编码

    "page":  "pages/detail/detail", # 目标页面

    "width": 430,

    "is_hyaline": True              # 透明背景，永久有效

}

img_bytes = requests.post(qr_url, json=payload).content

with open('qrcode.png', 'wb') as f:

    f.write(img_bytes)

html

javascript

Page({

  onLoad(options) {

    // 无限码场景

    const scene = decodeURIComponent(options.scene); // "item_123"

    // 普通码场景

    const id = options.id;

    // 根据 scene/id 拉取业务数据

  }

})