小程序二维码生成接口API

Posted 2021-01-01 hnhycnlc888

获取小程序码

 

我们推荐生成并使用小程序码，它具有更好的辨识度。目前有两个接口可以生成小程序码，开发者可以根据自己的需要选择合适的接口。

接口A: 适用于需要的码数量较少的业务场景 接口地址：

https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN

获取 access_token 详见文档

POST 参数说明

注意：通过该接口生成的小程序码，永久有效，数量限制见文末说明，请谨慎使用。用户扫描该码进入小程序后，将直接进入 path 对应的页面。

接口B：适用于需要的码数量极多，或仅临时使用的业务场景

接口地址：

https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN

获取 access_token 详见文档

注意：通过该接口生成的小程序码，永久有效，数量暂无限制。用户扫描该码进入小程序后，开发者需在对应页面获取的码中 scene 字段的值，再做处理逻辑。使用如下代码可以获取到二维码中的 scene 字段的值。调试阶段可以使用开发工具的条件编译自定义参数 scene=xxxx 进行模拟，开发工具模拟时的 scene 的参数值需要进行 urlencode

 

1.  
   // 这是首页的 js
2.  
   Page({
3.  
   onLoad: function(options) {
4.  
   // options 中的 scene 需要使用 decodeURIComponent 才能获取到生成二维码时传入的 scene
5.  
   var scene = decodeURIComponent(options.scene)
6.  
   }
7.  
   })

获取小程序二维码

 

接口C：适用于需要的码数量较少的业务场景

接口地址：

https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN

获取 access_token 详见文档

注意：通过该接口生成的小程序二维码，永久有效，数量限制见文末说明，请谨慎使用。用户扫描该码进入小程序后，将直接进入 path 对应的页面。

示例：

{"path": "pages/index?query=1", "width": 430}

注：pages/index 需要在 app.json 的 pages 中定义

Bug & Tip

1. tip：通过该接口，仅能生成已发布的小程序的二维码。
2. tip：可以在开发者工具预览时生成开发版的带参二维码。
3. tip：接口A加上接口C，总共生成的码数量限制为100,000，请谨慎调用。
4. tip: POST 参数需要转成 json 字符串，不支持 form 表单提交。
5. tip: auto_color line_color 参数仅对小程序码生效。