获取二维码

收藏
我的收藏

接口介绍​

该接口用于第三方小程序应用为授权小程序获取小程序对应版本阶段的二维码。​
注意:​
    这里的版本阶段指的是线上版本审核版本测试版本
    对于线上版,二维码中不包含版本号的信息,所以不管发过多少次版本,生成的二维码都是一样的,并且扫码看到的都是最新版本的内容。

请求​

基本信息​

基本
HTTP URL
HTTP Method
POST
权限要求
授权小程序授予基本信息设置权限​

查询参数​

参数名
参数类型
是否必须
备注
component_appid
string
是​
第三方小程序应用 appid​
authorizer_access_token
string
是​
授权小程序接口调用凭据​

请求体(json)​

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

请求体示例​

{ "version": "latest", "path": "pages/result/index?name=xxx" }
注意:​
    如果配置了 path,但是不生效,检查前面是否多带了 "/"。
    如果设置了有效的 path,则扫描二维码后直接跳转到 path 指定的页面;否则跳转到首页。

响应​

响应体​

正确情况下返回图像的字节流,响应 header 中包含:​
HTTP/1.1 200 OK Content-Type: image/png

错误码​

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