几种生成微信小程序二维码的方案

7,143 阅读4分钟

一、手动生成

在微信公众平台 https://mp.weixin.qq.com/ 扫码登录之后,点击右上角工具 --> 生成小程序码 --> 填入小程序页面路径 --> 生成

image.png

不知道页面路径的可以点击获取更多页面路径,输入小程序项目成员的微信号开启入口

image.png

通过微信打开小程序后,点击右上角三个点,再点击左下角复制页面路径

image.png

image.png

二、接口生成

1、接口A:适用于需要的码数量较少的业务场景

生成小程序码,可接受 path 参数较长,生成个数受限,数量限制见 注意事项,请谨慎使用。

POST https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN
请求参数
属性类型必填说明
access_tokenstring接口调用凭证,该参数为 URL 参数,非 Body 参数。使用getAccessToken 或者 authorizer_access_token
pathstring扫码进入的小程序页面路径,最大长度 1024 个字符,不能为空,scancode_time为系统保留参数,不允许配置;对于小游戏,可以只传入 query 部分,来实现传参效果,如:传入 "?foo=bar",即可在 wx.getLaunchOptionsSync 接口中的 query 参数获取到 {foo:"bar"}。
widthnumber二维码的宽度,单位 px。默认值为430,最小 280px,最大 1280px
auto_colorboolean默认值false;自动配置线条颜色,如果颜色依然是黑色,则说明不建议配置主色调
line_colorobject默认值{"r":0,"g":0,"b":0} ;auto_color 为 false 时生效,使用 rgb 设置颜色 例如 {"r":"xxx","g":"xxx","b":"xxx"} 十进制表示
is_hyalineboolean默认值false;是否需要透明底色,为 true 时,生成透明底色的小程序码
env_versionstring要打开的小程序版本。正式版为 "release",体验版为 "trial",开发版为 "develop"。默认是正式版。
返回参数
属性类型说明
bufferbuffer图片 Buffer
errcodenumber错误码
errmsgstring错误信息

2、接口B:适用于需要的码数量极多的业务场景

生成小程序码,可接受页面参数较短,生成个数不受限。

POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN 
请求参数
属性类型必填说明
access_tokenstring接口调用凭证,该参数为 URL 参数,非 Body 参数。使用getAccessToken 或者 authorizer_access_token
scenestring最大32个可见字符,只支持数字,大小写英文以及部分特殊字符:!#$&'()*+,/:;=?@-._~,其它字符请自行编码为合法字符(因不支持%,中文无法使用 urlencode 处理,请使用其他编码方式)
pagestring默认是主页,页面 page,例如 pages/index/index,根路径前不要填加 /,不能携带参数(参数请放在scene字段里),如果不填写这个字段,默认跳主页面。scancode_time为系统保留参数,不允许配置
check_pathbool默认是true,检查page 是否存在,为 true 时 page 必须是已经发布的小程序存在的页面(否则报错);为 false 时允许小程序未发布或者 page 不存在, 但page 有数量上限(60000个)请勿滥用。
env_versionstring要打开的小程序版本。正式版为 "release",体验版为 "trial",开发版为 "develop"。默认是正式版。
widthnumber默认430,二维码的宽度,单位 px,最小 280px,最大 1280px
auto_colorbool自动配置线条颜色,如果颜色依然是黑色,则说明不建议配置主色调,默认 false
line_colorobject默认是{"r":0,"g":0,"b":0} 。auto_color 为 false 时生效,使用 rgb 设置颜色 例如 {"r":"xxx","g":"xxx","b":"xxx"} 十进制表示
is_hyalinebool默认是false,是否需要透明底色,为 true 时,生成透明底色的小程序
返回参数
属性类型说明
bufferbuffer图片 Buffer
errcodenumber错误码
errmsgstring错误信息

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

生成二维码,可接受 path 参数较长,生成个数受限,数量限制见 注意事项

POST https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN
请求参数
属性类型必填说明
access_tokenstring接口调用凭证,该参数为 URL 参数,非 Body 参数。使用access_token或者authorizer_access_token
pathstring扫码进入的小程序页面路径,最大长度 128 个字符,不能为空;对于小游戏,可以只传入 query 部分,来实现传参效果,如:传入 "?foo=bar",即可在 wx.getLaunchOptionsSync 接口中的 query 参数获取到 {foo:"bar"}。scancode_time为系统保留参数,不允许配置。
widthnumber二维码的宽度,单位 px。最小 280px,最大 1280px;默认是430
返回参数
属性类型说明
bufferBuffer图片 Buffer
errcodeint错误码
errmsgstring错误信息

注意事项

  1. 接口只能生成已发布的小程序的二维码
  2. 接口 A 加上接口 C,总共生成的码数量限制为 100,000,请谨慎调用。
  3. 接口 B 调用分钟频率受限(5000次/分钟),如需大量小程序码,建议预生成。