快缩短网址 · 小程序二维码优雅生成指南
项目主页：suo.run

一、官方 API：云端生码，稳若磐石
1. 接口速览
• getwxacode（接口 A）
场景：限量 10 万枚，永久有效，适合活动海报、商品详情。
参数速写：

json

  {

    "path": "pages/detail/detail?id=123",

    "width": 430

  }

  

• getwxacodeunlimit（接口 B，推荐）
场景：无上限、可携带动态参数，邀请码、分销链接首选。
参数速写：

json

  {

    "scene": "invite_code=ABC123",

    "page": "pages/index/index",

    "width": 430

  }

  

2. 三步落地
① 换取 access_token

bash

curl "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET"

② 云端生图

bash

curl -X POST "https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN" \

     -d '{"scene":"invite_code=ABC123","page":"pages/index/index","width":430}' \

     --output qrcode.png

③ 前端渲染
``javascript
wx.request({
url: 'https://your-api.com/qrcode',
responseType: 'arraybuffer',
success: res => {
this.setData({
qrcode: data:image/png;base64,${wx.arrayBufferToBase64(res.data)}
});
}
});

二、前端直绘：零后端，即刻成图  

引入 weapp-qrcode，三步即现。  

javascript
import drawQrcode from '../../utils/weapp-qrcode.js';



Page({
onLoad() {
drawQrcode({
canvasId: 'myQrcode',
width: 200,
height: 200,
text: 'https://suo.run?scene=123',
background: '#ffffff',
foreground: '#000000'
});
}
});

WXML 仅需：  

xml

``

三、非开发场景：指尖轻点，立取高清
登录微信公众平台 → 小程序 → 设置 → 小程序码及线下物料下载 → 选尺寸、挑配色 → 一键下载。

四、第三方平台：可视化定制，灵感不设限
• cli.im：LOGO 嵌入、渐变色、艺术二维码。
• weixin.hotapp.cn：专注小程序，带访问统计。
操作：填入 APPID 与页面路径 → 调色、加 LOGO → 生成 → 下载。

五、锦囊妙计
• 未发布的小程序无法生码，请先上架。
• scene 参数务必 encodeURIComponent，避免解析失败。
• 路径需在 app.json 注册，否则扫码即 404。
• appid & secret 请深藏不露，防止恶意调用。

按场景速配
少量固定 → 接口 A
海量动态 → 接口 B
极速原型 → weapp-qrcode
非技术同学 → 公众平台 or 第三方



快缩短网址 suo.run，让每一次扫码都优雅抵达。