开发
API

扫普通链接二维码打开小程序

为了方便小程序开发者能更便捷地推广小程序,兼容线下已有的二维码,抖音开放平台开放扫描普通链接二维码跳转到抖音小程序能力。

宿主接入

抖音和抖音极速版 20.4 以上支持

功能介绍

普通链接二维码,是指开发者使用工具对网页链接进行编码后生成的二维码。

线下商户可不需更换线下二维码,在小程序后台完成配置后,即可在用户扫描普通链接二维码时打开小程序,使用小程序的功能。

对于普通链接二维码,目前支持使用抖音“扫一扫”或抖音内打开图片识别二维码跳转小程序。

二维码跳转规则

抖音客户端扫码将按以下匹配规则控制跳转:

  1. 二维码链接的协议、域名与已配置的二维码规则一致。
  2. 二维码链接属于后台配置的二维码规则的子路径。(如需支持子路径匹配,请确认后台配置的二维码规则以/结尾)
  3. 如果二维码规则包含参数,链接?后为参数部分,参数要求前缀匹配。

配置流程

登录小程序后台,进入“设置-基础设置-关联设置-普通二维码绑定”,开启功能后即可配置二维码规则。

二维码规则

根据二维码跳转规则,开发者需要填写需要跳转小程序的二维码规则。要求如下:

  1. 二维码规则的域名须通过 ICP 备案的验证。
  2. 支持 http、https 开头的链接(如:http://open.dy.comhttps://open.dy.com/mp/https://open.dy.com/mp?id=123)。
  3. 一个小程序帐号可配置不多于 100 个二维码前缀规则。

前缀占用规则

开发者可选择是否占用符合二维码匹配规则的所有子规则。如选择占用,则其他帐号不可申请使用满足该前缀匹配规则的其他子规则。

如:若开发者 A 配置二维码规则:https://open.dy.com/mp?id=123,并选择“占用所有子规则“,其他开发者将不可以配置满足前缀匹配的子规则如https://open.dy.com/mp?id=1234

校验文件

下载随机校验文件,并将文件上传至服务器指定位置的目录下,方可通过所属权校验。

验证文件放置规则: 放置于 URL 中声明的最后一级子目录下,若无子目录,则放置于 host 所属服务器的顶层目录下。请根据页面提示将验证文件放置在指定的目录下。

小程序功能页面

配置扫描二维码后打开的小程序功能页面路径,如:pages/index/index

测试调试

开发者可对已配置的二维码规则进行测试和调试。

测试仅对指定的测试链接和测试范围内的抖音用户生效,其他用户扫码后跳转网页,不影响全网用户正常使用。在二维码规则发布后,开发者仍然可以选择在指定版本(测试版/线上版本)下测试,请注意扫码用户要打开开发版必须提交过代码。

点击纠错
该文档是否对你的开发有所帮助?
有帮助
没帮助
该文档是否对你的开发有所帮助?
有帮助
没帮助