获取二维码V2
接口说明
该接口用于第三方小程序应用为授权小程序获取小程序对应版本阶段的二维码。
注意:
- 这里的版本阶段指的是线上版本、审核版本、测试版本。
- 对于线上版,二维码中不包含版本号的信息,所以不管发过多少次版本,生成的二维码都是一样的,并且扫码看到的都是最新版本的内容。
基本信息
名称 | 描述 |
---|---|
HTTP URL | https://open.douyin.com/api/apps/v2/basic_info/get_qr_code/ |
HTTP Method | POST |
Scope | ma.basic.info |
权限要求 | 授权小程序授予基本信息设置权限,可前往授权权限集说明查看说明。 |
请求参数
请求头
access-token必填String
示例:isvact.0801121846735352506a356a6
content-type必填String
示例:application/json
固定值"application/json"
Body
version必填String
示例:current
版本阶段: current 或 audit 或 latest; current 线上版; audit 审核版; latest 测试版
pathString
示例:pages/index
小程序启动参数,包含两部分: 页面路径?页面参数
请求示例
curl --location 'https://open.douyin.com/api/apps/v2/basic_info/get_qr_code/' \ --header 'access-token: isvact.xxxxxxxxkqei7GsVGN' \ --header 'Content-Type: application/json' \ --data '{ "version": "latest", "path": "xxxx/xxxx" }'
响应参数
Body展开全部子属性
err_msg必填String
错误描述
err_no必填Int32
示例:0
错误码
log_id必填String
示例:20240116204738BF50CE363C57B719C353
标识请求的唯一id
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "data": { "qr_code_url": "xxxxxxx" }, "err_msg": "", "err_no": 0, "log_id": "20240116204738BF50CE363C57B719C353" }
错误码
HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
---|---|---|---|
200 | 40030 | 生成的二维码为空,请检查当前版本是否有效 | |
200 | 28001005 | 系统内部错误,请重试 | 请求重试,若依然无解请向平台提交反馈 |
200 | 28001003 | access_token无效 | 重新请求生成access_token |
200 | 28001008 | access_token过期,请刷新或重新授权 | 重新请求生成access_token |
200 | 28001016 | 当前应用已被封禁或下线 | clientKey被封禁或者下线 |
200 | 28001006 | 网络调用错误,请重试 | 重试即可 |
200 | 28001014 | 应用未授权任何能力 | 确认应用是否授权能力 |
200 | 28001018 | 应用未获得该能力 | 开通相关能力 |
200 | 28003017 | quota已用完 | 联系平台处理 |
200 | 28001019 | 应用该能力已被封禁 | 该能力被封禁,联系平台处理 |
200 | 28001007 | 参数不合法 | 根据错误信息检查请求参数是否填写正常 |