获取微信小程序二维码

BaaS.getWXACode(type, params, cdn, categoryName)

通过该接口可以获取小程序任意页面的二维码，扫描该二维码可以直接进入小程序对应的页面。目前支持生成小程序码和小程序二维码。

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

参数说明

参数 类型 必填 说明
type String Y 支持 'wxacode', 'wxacodeunlimit', 'wxaqrcode' 三种类型，详情查看以下「选择二维码类型」
params Object Y 小程序码或小程序二维码的配置参数，详情查看以下「选择二维码类型」
cdn Bool N 是否上传二维码到文件存储并返回图片链接，默认为 false
categoryName String N 指定上传文件分类名，cdn 为 true 时有效，不指定该参数或分类名不存在，则默认上传到根目录

接口返回

返回字段说明

参数 类型 说明
image String 二维码的 base64 编码
download_url String 请求参数 cdn=true 时返回，二维码的下载链接
uploaded_file Object 请求参数 cdn=true 时返回，图片文件对象。SDK >= v3.4 返回改参数

uploaded_file 参数说明：

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

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

  • 未在知晓云后台开启生成小程序码权限
  • 传递的参数不合法
  • 设置 type='wxacodeunlimit' 时，接口调用频率超过限制(目前 5000次/分钟）
  • 设置 type='wxacode' 或 type='wxaqrode'时，接口生成的码数大于限制
  • 设置 type='wxacodeunlimit' 时，所传的 page 页面不存在，或者小程序没有发布

选择二维码类型

设置 type 为 wxacode，params 支持以下配置项：

参数 类型 必填 说明
path String Y 不能为空，最大长度 128 字节
width Int N 二维码的宽度，默认值为 430
auto_color Bool N 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调，默认值为 false
line_color Object N auth_color 为 false 时生效，使用 rgb 设置颜色 例如 {"r":"xxx","g":"xxx","b":"xxx"},十进制表示，默认值为 {"r":"0","g":"0","b":"0"}
is_hyaline Bool N 是否需要透明底色，is_hyaline 为true时，生成透明底色的小程序码

此类型适用于需要的码数量较少的业务场景。此时生成的小程序码，永久有效，数量有限（与 wxaqrcode 生成的小程序二维码加起来不超过 100000），请谨慎使用。用户扫描该码进入小程序后，将直接进入 path 对应的页面。

请求示例

const params = {
  path: '../user/index?id=123456',
  width: 250
}

// 获取二维码的 base64
BaaS.getWXACode('wxacode', params).then(res => {
  callback(null, res.image)
}).catch(err => {
  // HError 对象
  callback(err)
})

// 获取二维码的下载链接（知晓云会先自动上传到文件存储，返回 CDN 链接）
BaaS.getWXACode('wxacode', params, true).then(res => {
  callback(null, {
    imageBase64: res.image,
    imageURL: res.download_url
  })
}).catch(err => {
  // HError 对象
  callback(err)
})

设置 type 为 wxacodeunlimit，params 支持以下配置项：

参数 类型 必填 说明
scene String Y 最大32个可见字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~，其它字符请自行编码为合法字符（因不支持%，中文无法使用 urlencode 处理，请使用其他编码方式）
page String Y 必须是已经发布的小程序存在的页面（否则报错），例如 "pages/index/index" ,根路径前不要填加'/',不能携带参数（参数请放在scene字段里），如果不填写这个字段，默认跳主页面
width Int N 二维码的宽度，默认值为 430
auto_color Bool N 自动配置线条颜色，如果颜色依然是黑色，则说明不建议配置主色调，默认值为 false
line_color Object N auth_color 为 false 时生效，使用 rgb 设置颜色 例如 {"r":"xxx","g":"xxx","b":"xxx"},十进制表示，默认值为 {"r":"0","g":"0","b":"0"}
is_hyaline Bool N 是否需要透明底色，is_hyaline 为true时，生成透明底色的小程序码

此类型适用于需要的码数量极多，或仅临时使用的业务场景。此时生成的小程序码，永久有效，数量暂无限制。用户扫描该码进入小程序后，开发者需在对应页面获取的码中 scene 字段的值，再做处理逻辑。

请求示例

const params = {
  scene: 'A',
  page: 'pages/index/index',
  width: 250
}

BaaS.getWXACode('wxacodeunlimit', params).then(res => {
  callback(null, res.image)
}).catch(err => {
  // HError 对象
  callback(err)
})

设置 type 为 wxaqrcode，params 支持以下配置项：

参数 类型 必填 说明
path String Y 不能为空，最大长度 128 字节
width Int N 二维码的宽度，默认值为 430

此类型适用于需要的码数量较少的业务场景。此时生成的小程序码，永久有效，数量有限（与 wxacode 生成的小程序二维码加起来不超过 100000），请谨慎使用。用户扫描该码进入小程序后，将直接进入 path 对应的页面。

请求示例

const params = {
  path: '../user/index?id=123456',
  width: 250
}

BaaS.getWXACode('wxaqrcode', params).then(res => {
  callback(null, res.image)
}).catch(err => {
  // HError 对象
  callback(err)
})

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

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

results matching ""

    powered by

    No results matching ""