收藏
评论

URL Scheme 和 URL Link 优化公告官方

为了帮助开发者更好地为用户提供服务,降低开发者使用 URL Scheme 和 URL Link 的成本,自 2023 年 12 月 19 日起,微信团队将对 URL Scheme 和 URL Link 进行如下优化:


1、新增明文 URL Scheme,开发者无需调用接口可自行拼接并且生成明文 Scheme;

2、取消 URL Scheme 和 URL Link 打开端一人一链的限制,支持同一条链接被多名用户访问;

3、新增打开端限制:每个小程序每天 URL Scheme 和 URL Link 总打开次数上限为 300 万次。




一、新增明文 URL Scheme

开发者无需调用平台接口,可自行根据如下格式拼接 appid 和 path 等参数,作为 URL Scheme 链接。

weixin://dl/business/?appid=*APPID*&path=*PATH*&query=*QUERY*&env_version=*ENV_VERSION*


其中各参数含义如下:


注意:

1、为保护开发者,通过明文 URL Scheme 拉起的小程序(页面)必须要提前在「小程序管理后台 -> 设置 -> 隐私与安全 -> 明文 scheme 拉起此小程序」中进行声明;

  • 小程序:配置能够通过明文 scheme 进入的小程序页面

  • 小游戏:打开开关即可通过明文 scheme 拉起小游戏

2、通过明文 URL Scheme 打开小程序的场景值为 1286;

3、明文 URL Scheme 不受每天 50 万次的生成量限制;

4、明文 URL Scheme 没有有效期的概念,可长期有效;

5、明文 URL Scheme 没有一人一链的打开限制,支持一条链接同时被多名用户访问。



二、原 URL Scheme 升级为加密 URL Scheme,并支持自行拼接参数

目前已对外提供的 URL Scheme 能力平滑升级为加密 URL Scheme,取消一人一链的限制,支持开发者自行在链接后拼接参数*CUSTOM PARAMETER*

注意:之前通过平台接口生成的 URL Scheme 可继续使用,链接自动可支持多人打开。


URL Scheme格式

weixin://dl/business/?t=*TICKET*&cq=*CUSTOM PARAMETER*

其中参数含义如下:

注意:加密 URL Scheme 打开小程序的场景值保持不变,仍为 1065。



三、原 URL Link 升级为加密 URL Link,并支持自行拼接参数

目前已对外提供的 URL Link 能力平滑升级为加密 URL Link,取消一人一链的限制,支持开发者自行在链接后拼接参数*CUSTOM PARAMETER*

注意:之前通过平台接口生成的 URL Link 可继续使用,链接自动可支持多人打开。


URL Link格式:

https://wxaurl.cn/*TICKET*?cq=*CUSTOM PARAMETER*

其中参数含义如下:

注意:加密 URL Link 打开小程序的场景值保持不变,微信外打开的场景值为 1194;微信内打开会调整为开放标签打开小程序,场景值为 1167。



四、调用规则调整

1、加密 URL Scheme 和 URL Link 取消一人一链,支持一条链接同时被多名用户访问,生效后之前生成的链接被多名用户访问时,不会再报错;

2、每个小程序每天能够生成加密 URL Scheme 和 URL Link 共计 50 万条的限制不变,额外增加每个小程序每天在微信外,能够通过链接打开小程序共计 300 万次的打开量限制,其中链接包括加密 URL Scheme、加密 URL Link 和明文 URL Scheme ;若链接打开小程序的次数超过 300 万次/天,则无法通过链接在微信外拉起小程序;

3、URL Scheme (加密和明文)和 URL Link (加密)仅支持非个人主体小程序使用;

4、注意事项:平台有安全策略防止开发者的链接被黑灰产大量打开,可能导致达到访问上限无法正常通过链接打开小程序的问题;

5、查询方式:开发者可复用现有的查询方式对 URL Scheme 和 URL Link 进行打开额度查询和链接状态查询。


138262浏览
最后一次编辑于  2023-12-19
收藏

73 个评论

  • gh
    gh
    2024-12-31

    h5页面目前测试安卓、ios16/17/18都可以在微信浏览器跳转到小程序

    2024-12-31
    赞同
    回复 1
    • gh
      gh
      2024-12-31
      是使用了明文sceme
      2024-12-31
      回复
  • Zero
    Zero
    2024-12-24

    iOS 使用urlink 跳转 打开提示:“对不起,当前页面无法访问” 怎么解决啊。 真的无解了 能跳转 但是打不开 。。。。。。。。

    2024-12-24
    赞同
    回复
  • @城
    @城
    2024-12-02
    所以,这里配置的path是需要上线后小程序的路径吗?到底有什么校验规则?为什么跳转的路径可以携带参数env_version,我添加体验版小程序的路径一直提示path错误呢?
    
    
    
    2024-12-02
    赞同
    回复
  • Heaven
    Heaven
    2024-12-01

    请问short link 现在是否可以一链多人呢

    2024-12-01
    赞同
    回复
  • null
    null
    2024-11-08

    webview嵌套得H5页面,跳转到URL Link  显示无法跳转,但是直接点URL Link可以跳转到一个进入确认进入小程序页面。

    2024-11-08
    赞同
    回复
  • 龙的心
    龙的心
    2024-11-04
    query 参数支持{}吗?因为目前我们的电商类小程序需要采用这个拼接参数方法,会有无法唤起小程序以及唤起耗时特别长的情况吗?
    


    2024-11-04
    赞同
    回复
  • fantasy
    fantasy
    2024-10-20

    2024年10月20日 安卓用url scheme就是拉不起来,iOS可以,电脑可以。换URLlink,要二次跳转,但是好歹安卓微信都可以了,但是pc又不行了

    2024-10-20
    赞同
    回复
  • Internal Server Error
    Internal Server Error
    2024-10-17

    关于链接的有效期方面是否有改动?

    API文档说明中还是有这个“is_expire”字段,但实际上是不是根本就没有这个字段了?最长的期限就是30天,无法再生成永久的了。

    2024-10-17
    赞同
    回复
  • CodeFarmer
    CodeFarmer
    2024-09-27

    URL Link生成的链接,点击之后会有个带打开小程序按钮的页面,可否不经过这一步,点击直接进入小程序页面?


    2024-09-27
    赞同
    回复
  • 狼宝堡长
    狼宝堡长
    2024-09-20

    weixin://dl/business/?appid=wxa151d6589ab99d34&path=subpages/hotSpotAuthentication/index&query=174326067

    这个scheme码有错误吗,拿不到query里面的数据,在开发者工具里面使用快速scheme也报错,错误码10020

    2024-09-20
    赞同
    回复

正在加载...

登录 后发表内容