获取字节跳动小程序二维码

tt.BaaS.getQRCode({path, platform, width, lineColor, background, setIcon, categoryName, categoryId})

通过该接口可以获取小程序任意页面的二维码,扫描该二维码可以直接进入小程序对应的页面。

调用该接口前,请确保在 知晓云管理后台-小程序设置页面-SDK 功能设置 中已开启相应权限。

参数说明

参数 类型 必填 说明
path String N 小程序/小游戏启动参数,小程序则格式为 ?,小游戏则格式为 JSON 字符串,默认为空
platform String N path 字段指定时,该字段必填,取值: miniapp(小程序)/ minigame(小游戏)
width Integer N 二维码宽度,单位 px,最小 280,最大 1280,默认为 430
lineColor Object N 二维码线条颜色,默认为黑色,格式:{"r":0,"g":0,"b":0}
background Object N 二维码背景颜色,默认为透明,格式:{"r":0,"g":0,"b":0}
setIcon Boolean N 是否展示小程序/小游戏 icon,默认不展示
categoryName String N 二维码存储的分类名称
categoryId Inter N 二维码存储的分类 ID, 当名称、ID 同时存在时,ID 优先

AppName 支持的值为:

说明
toutiao 今日头条
douyin 抖音

接口返回

返回字段说明

参数 类型 说明
categories Array 分类
path String 上传成功后的访问地址 URL
cdn_path String 文件在 CDN 中的相对路径
id Object 文件 ID
mime_type String 文件媒体类型
name String 文件名
size Number 以字节为单位
created_at String 文件上传时间

以下几种情况会返回 400 错误:

  • 未在知晓云后台开启生成小程序码权限
  • 传递的参数不合法

请求示例

tt.BaaS.bytedance.getQRCode({
  path: 'pages/index/index?a=10&b=20',
  platform: 'miniapp',
  width: 280,
}).then(res => {
  callback(null, res.image_url)
})

HError 对象结构请参考错误码和 HError 对象

了解更多获取二维码的信息,可参考字节跳动小程序文档 - 二维码 章节

results matching ""

    powered by

    No results matching ""