获取二维码

更新时间 2024-07-24 02:58:49

我的收藏

接口介绍

该接口用于第三方小程序应用为授权小程序获取小程序对应版本阶段的二维码。

注意：

•

这里的版本阶段指的是线上版本、审核版本、测试版本。

•

对于线上版，二维码中不包含版本号的信息，所以不管发过多少次版本，生成的二维码都是一样的，并且扫码看到的都是最新版本的内容。

基本
HTTP URL	https://open.microapp.bytedance.com/openapi/v1/microapp/app/qrcode
HTTP Method	POST
权限要求	授权小程序授予基本信息设置权限

参数名	参数类型	是否必须	备注
version	string	是	版本阶段： current 或 audit 或 latest current 线上版 audit 审核版 latest 测试版
path	string	否	小程序启动参数，包含两部分: 页面路径?页面参数

json复制
{
  "version": "latest",
  "path": "pages/result/index?name=xxx"
}

注意：

•

如果配置了 path，但是不生效，检查前面是否多带了 "/"。

•

如果设置了有效的 path，则扫描二维码后直接跳转到 path 指定的页面；否则跳转到首页。

正确情况下返回图像的字节流，响应 header 中包含：

js复制
HTTP/1.1 200 OK

Content-Type: image/png

错误码	message
40001	参数错误
40003	找不到相关第三方小程序应用
40004	找不到相关授权小程序
40020	第三方小程序应用 authorizer_access_token 不正确或者已过期
40030	生成的二维码为空，请检查当前版本是否有效
40036	授权小程序未授予该接口对应的权限