接口说明

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

注意:

  • 这里的版本阶段指的是线上版本审核版本测试版本
  • 对于线上版,二维码中不包含版本号的信息,所以不管发过多少次版本,生成的二维码都是一样的,并且扫码看到的都是最新版本的内容。

基本信息

名称描述
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 状态码错误码错误码描述排查建议
20040030
生成的二维码为空,请检查当前版本是否有效