开发 | 小程序如何生成带参数二维码？

许多小程序开发者，都需要获取进入小程序不同页面的二维码：包括常见的四方形「QR 码」和新推出的「小程序码」。

这时候，我们直接在小程序后台中获取到的二维码，就远远无法满足我们以上需求了。贴心的是，微信提供了「获取小程序二维码」的接口。

通过这个接口，商家和开发者能够制作进入不同页面的小程序二维码，而不会限定扫码进入小程序主页。

下面，知晓程序（微信号 zxcx0101）就以「虚荣数据库」小程序的某个英雄详情页为例，展示这个接口的使用方法。

首先，我们需要确保在小程序的 app.json 代码中，已经注册了相应的页面。

在本例的设定中，我们就需要在 pages 里，将 pages/detail/hero/hero 这个页面注册进去。

"pages":[
  "pages/index/index",
  "pages/detail/hero/hero"
]

当然，相应目录下也需要有相应的页面文件，且你的小程序已经有已发布的线上版本。否则，用户扫码后，微信会提示出错。

接下来，我们需要到微信小程序后台，获取小程序的 AppSecret（如果已经获取，这一步可以跳过）。

进入小程序后台，点击左侧「设置」，找到「开发设置」，我们就能找到 AppSecret 一项。点击「获取」或「重置」，扫码之后，网页就会显示新的 AppSecret。

需要注意的是，如果你之前生成过新的 AppSecret，那么旧的 AppSecret 会随这个操作而失效。

开发者也需要记得妥善保管 AppSecret，尽可能保证 AppSecret 不会丢失、泄漏。

有了小程序的 AppID 和 AppSecret，我们就能利用服务器，获取小程序的二维码了。

在本例，我们通过模拟请求的方式，让大家了解这个接口的使用方法和原理。

首先，我们要利用 AppID 和 AppSecret，获取 Access Token。

这一步，我们请求的地址是 https://api.weixin.qq.com/cgi-bin/token，你需要使用 GET 方法，传递你的 AppID 和 AppSecret。

从结果中，我们可以得知：执行这个操作后，微信会给你返回一个 JSON 数据包。解析这个数据包，我们就可以获得 Access Token。

有了 Access Token，我们就可以获取不同的小程序二维码了。

微信提供了两个 POST 获取小程序二维码的接口。你可以根据你的业务需求，自由选择任一接口，获取相应的小程序二维码（GET 参数中的 ACCESS_TOKEN 部分填入上一步我们获取到的 Access Token）。

获取最新的「菊花式」小程序码，可以使用这个接口：https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN。
想要经典的「狗皮膏药式」QR 码，可以使用这个接口：https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN

POST 请求体中，需要包含小程序的页面地址，以及传入小程序的参数。记住，这个页面必须要在小程序里的 app.json 进行注册。

本例中，JSON 请求体如下：

{"path": "pages/detail/hero/hero?hero=kestrel"}

发送请求后，微信会直接返回一张制作好的「小程序码」。

现在，扫一扫这张小程序码，看看是不是到了指定页面了？

除了我们文中举例的接口，微信还开放了另一个与二维码相关的接口，就是「扫普通二维码进入小程序」。

通过这个接口，开发者自己就可以按照一定规律，自行批量生成 QR 码。但它需要开发者有已经备案的域名，且个人主体小程序无法使用这个接口。

微信将通过「获取小程序二维码」接口获取的二维码的数量限定在十万个，并且似乎并没有「注销以前生成的二维码」的功能和机制。

所以，如果你有非常大量的小程序二维码生成需求，建议使用普通链接二维码的方式生成 QR 码。如果需要使用微信提供的二维码生成接口，也要注意不要超过限额。

本文由知晓程序原创出品，关注微信号 zxcx0101，在微信后台回复「点评」，获取「大众点评点餐」小程序的全套开发经验。

zxcx_0208