通过后台接口可以获取小程序任意页面的二维码,扫描该二维码可以直接进入小程序对应的页面,所有生成的二维码永久有效,可放心使用。目前微信支持两种二维码,小程序码(左),小程序二维码(右),如下所示:
为满足不同需求和场景,官方提供了三个接口,开发者可挑选适合自己的接口。
- 生成小程序码,可接受 path 参数较长,生成个数受限,数量限制见 注意事项,请谨慎使用。(128字节)
- 生成小程序码,可接受页面参数较短,生成个数不受限。(32字节)
- 生成二维码,可接受 path 参数较长,生成个数受限,数量限制见 注意事项。(128字节)
注:
- 接口只能生成已发布的小程序的二维码
- 接口 A 加上接口 C,总共生成的码数量限制为 100,000,请谨慎调用。
- 接口 B 调用分钟频率受限(5000次/分钟),如需大量小程序码,建议预生成。
获取 access_token(小程序全局唯一后台接口调用凭据)
GET https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=APPID&secret=APPSECRET
参数: grant_type 填写 client_credential appid小程序唯一凭证,即 AppID,可在「微信公众平台 - 设置 - 开发设置」页中获得 secret 小程序唯一凭证密钥,即 AppSecret,获取方式同 appid
返回值:JSON数据包 access_token获取到的凭证 expires_in凭证有效时间,单位:秒。
接口A获取二维码:
POST https://api.weixin.qq.com/wxa/getwxacode?access_token=ACCESS_TOKEN
参数: access_token 接口调用凭证 path 扫码进入的小程序页面路径,最大长度 128 字节,不能为空
返回值说明:如果调用成功,会直接返回图片二进制内容,如果请求失败,会返回 JSON 格式的数据。
接口B获取二维码:
POST https://api.weixin.qq.com/wxa/getwxacodeunlimit?access_token=ACCESS_TOKEN
参数:access_token 接口调用凭证 scene 最大32个可见字符,只支持数字,大小写英文以及部分特殊字符 page 必须是已经发布的小程序存在的页面(否则报错),例如 pages/index/index
, 根路径前不要填加 /
,不能携带参数(参数请放在scene字段里),如果不填写这个字段,默认跳主页面
返回值说明:如果调用成功,会直接返回图片二进制内容,如果请求失败,会返回 JSON 格式的数据。
接口C获取二维码:
POST https://api.weixin.qq.com/cgi-bin/wxaapp/createwxaqrcode?access_token=ACCESS_TOKEN
参数:access_token接口调用凭证 path 扫码进入的小程序页面路径,最大长度 128 字节,不能为空
返回值说明:如果调用成功,会直接返回图片二进制内容,如果请求失败,会返回 JSON 格式的数据。