接口说明

获取小程序/小游戏的二维码或者抖音码（圆形的样式，异形码）。二维码可通过任意 App 扫码打开，能跳转到开发者指定的对应字节系 App 内拉起小程序/小游戏，并传入开发者指定的参数，抖音码仅支持字节系 App 扫码打开。通过该接口生成的二维码永久生效。开发者调用该接口来生成小程序二维码/抖音码，返回二维码图片二进制的base64编码。

使用限制

无

基本信息

名称	描述
HTTP URL	正式地址：https://open.douyin.com/api/apps/v1/qrcode/create/ 沙盒地址：https://open-sandbox.douyin.com/api/apps/v1/qrcode/create/
HTTP Method	POST
Scope	apps.qrcode.create
权限要求	获取二维码

请求参数

请求头

access-token必填String

示例：clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1KcxFnZ

调用https://open.douyin.com/oauth/client_token/生成的token

content-type必填String

固定值"application/json"

Body展开全部子属性

app_nameString

宿主 app，不传入默认为 toutiao - toutiao - douyin - douyin_lite - douyin_search - toutiao_lite - all

appidString

小程序 appid

backgroundStruct

二维码背景颜色

展开子属性

is_circle_codeBool

是否为圆形码，默认为 false

line_colorStruct

二维码线条颜色

展开子属性

pathString

小程序页面路径

set_iconBool

是否在二维码中心添加小程序 icon，默认为 false

widthInt32

二维码宽度，单位：像素

请求示例
curl --location --request POST 'https://open.douyin.com/api/apps/v1/qrcode/create/' \
--header 'Content-Type: application/json' \
--header 'access-token: clt.943da17996fb5cebfbc70c044c3fc25a57T54DcjT6HNKGqnUdxzy1******'
--data-raw '{
  "app_name": "douyin",
  "appid": "tt**********",
  "path": "{}",
  "width": 1000,
  "line_color": {
    "r": 0,
    "g": 0,
    "b": 0
  },
  "background": {
    "r": 0,
    "g": 0,
    "b": 0
  },
  "set_icon": false
}'

响应参数

Body展开全部子属性

dataStruct

展开子属性

err_msgString

err_noInt32

log_idString

响应示例
正常响应示例异常响应示例
{
  "err_no": 0,
  "err_msg": "",
  "log_id": "202403081551526176B7485DDDA9025BXX",
  "data": {
    "img": "#######"
  }
}

切换单列布局

错误码

HTTP 状态码	错误码	错误码描述	排查建议
200	28005001	参数解析失败	检查参数必填字段和类型
200	28005006	小程序名称异常	小程序名称异常
200	28001008	access_token错误	重新获取access_token，见client_token获取说明
200	28005005	长宽超出限制	重新设置合理长宽
200	28005002	系统异常	重试
200	28005004	频率超出限制	稍后重试

准入条件

能力的准入条件如下：

1.

账号主体需为企业主体

2.

小程序已上线。

4.

小程序主营类目符合以下类目条件

一级类目	二级类目	三级类目
餐饮	餐饮	点餐平台
餐饮	餐饮	外卖平台
餐饮	餐饮	点评与推荐
餐饮	餐饮	菜谱
餐饮	餐饮	餐厅排队
餐饮	餐饮	餐饮门店
餐饮	餐饮	美食团购平台
生活服务	生活服务	传统娱乐
生活服务	生活服务	休闲玩乐平台
生活服务	生活服务	营业性演出票务
生活服务	生活服务	摄影/扩印
生活服务	生活服务	搬家服务
生活服务	生活服务	家政服务
生活服务	生活服务	高空清洗
生活服务	生活服务	月嫂/育儿嫂
生活服务	生活服务	电路检测维修
生活服务	生活服务	防水补漏/装修修缮
生活服务	生活服务	燃烧器具安装/维修
酒店旅游	酒店旅游	酒店住宿
酒店旅游	酒店旅游	景区服务
酒店旅游	酒店旅游	酒旅平台
零售	零售	综合商场
零售	零售	超市/便利店
零售	零售	品牌商家
交通出行	交通出行	航空
商业服务	商业服务	法律服务
商业服务	商业服务	律师事务所
商业服务	商业服务	心理咨询
电商	商家工具	任务玩法
电商	商家工具	权益营销
电商	商家工具	创意互动
电商	商家工具	商品展示
电商	商家工具	推荐导购
电商	商家工具	C2B购后定制
电商	商家工具	特殊交易
电商	商家工具	线下服务/线下活动
电商	商家工具	售后/其他品牌服务
房地产	房地产	商品房预售
房地产	房地产	房地产开发商
房地产	房地产	房地产资讯
房地产	房地产	房屋中介
房地产	房地产	物业管理
汽车	汽车	二手车
汽车	汽车	汽车报价/比价
汽车	汽车	汽车维修保养
汽车	汽车	汽车资讯
汽车	汽车	车展服务
汽车	汽车	汽车厂商/下属子（分）公司
汽车	汽车	汽车经销商/4S店
房地产	房地产	装修/建材
商业服务	商业服务	招聘/求职（中介）
商业服务	商业服务	第三方人力资源服务
商业服务	商业服务	工业品供应商
电商	商家工具	C2B购前定制

开发者文档

生成QRCodeV2（方形码/抖音圆码/异形码）

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

准入条件

生成QRCodeV2（方形码/抖音圆码/异形码）在线调试

接口说明

使用限制

基本信息

请求参数

响应参数

错误码

准入条件

生成QRCodeV2（方形码/抖音圆码/异形码）