文档

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

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

# 功能介绍

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

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

对于普通链接二维码，支持使用手机qq“扫一扫”或“qq内长按识别二维码”跳转小程序。

# 开放范围

所有企业类型小程序

# 二维码跳转规则

注意：手机qq客户端支持二维码规则根据“子路径匹配”。如原有二维码链接为

http://www.qq.com/a/123456

，其中12345为业务参数，则可配置规则

http://www.qq.com/a/

实现扫码打开小程序。

手机qq客户端扫码将按以下匹配规则控制跳转：

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

常见匹配错误类型：

后台已配置的二维码规则 线下二维码完整链接 错误原因
http://www.qq.com/a/b https://www.qq.com/a/b 协议不一致
https://www.qq.com/a/b https://q.qq.com/a/b 域名不一致
https://www.qq.com/a/b?id=123 https://www.qq.com/a/b?id=132 参数不满足前缀匹配
https://www.qq.com/a/b https://www.qq.com/a/bc 不属于子路径
https://www.qq.com/a/b https://www.qq.com/a/b/123 规则没有以/结尾，不支持子路径匹配

# 二维码内容获取：

在小程序后台配置二维码跳转小程序规则之后即可使用手机qq（870及以上客户端版本）扫码打开小程序。若二维码链接对应的规则有多个，按照最长规则进行匹配。

二维码链接内容会以参数q的形式带给页面，在onload事件中提取q参数并自行decodeURIComponent一次，即可获取原二维码的完整内容。

# 配置流程：

登录小程序后台，进入“设置-开发设置-扫普通链接二维码打开小程序”，即可配置二维码规则。

# 二维码规则：

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

  1. 二维码规则的域名须通过ICP备案的验证。
  2. 二维码规则的域名须配置在当前应用下。
  3. 一个小程序账号可配置不多于10个二维码前缀规则。

# 前缀占用规则

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

如：若开发者A配置二维码规则：

https://q.qq.com/mp?id=123

并选择“占用所有子规则“，其他开发者（包括自身）将不可以配置满足前缀匹配的子规则如

https://q.qq.com/mp?id=1234

如提示“规则和已有规则重复”，请联系对应小程序开发者沟通解决。

# 校验文件

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

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

# 小程序功能页面

配置扫描二维码后打开的小程序功能页面路径，如：

pages/index/index

# 测试调试

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

测试仅对指定的测试链接和测试范围内的qq用户生效，其他用户扫码后跳转维持现有逻辑。

注意：测试调试的规则不需要发布, 在二维码规则发布后，测试范围和测试链接失去意义，将全网用户范围生效。

# 测试范围

开发者可根据开发进度选择在开发版/体验版/线上版本测试“普通二维码跳转小程序”的功能。

举例说明：

  • 如果选择“体验版”，则对小程序有体验权限的用户会打开体验版本的小程序。
  • 如果选择“线上版本”，则对小程序有管理员、开发者、体验者权限的用户会打开正式版本的小程序。

# 测试链接

请完整填写符合二维码前缀匹配规则的链接用于测试，包括参数。

一个规则可以填写不多于5个测试链接，可多次修改。若二维码与测试链接匹配，且用户账号对”测试范围“有相应权限，将打开指定版本的小程序。

# 发布

测试完成后开发者可将二维码跳转规则发布现网，发布后扫描符合匹配规则的二维码，将跳转至指定的小程序页面。规则发布后全网用户生效，”测试链接“与”测试范围”的限定能力失效。

为确保用户体验，小程序必须先发布代码才可以发布二维码跳转规则。

← 接入 QQ 频道 →