收藏
评论

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 进行打开额度查询和链接状态查询。


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

116 个评论

  • 啊哈
    啊哈
    2023-12-19

    难得有这种利于开发者的更新了,不错不错。

    2023-12-19
    赞同 2
    回复
  • 崔文斌
    崔文斌
    2023-12-18

    明文 URL Scheme 可自行拼接 appid 和 path 等参数,如果 path 无页面参数变化的话,最终链接基本不会变化。是否可以理解为明文 URL Scheme 没有有效期为 30 天的限制,是一个长期有效的 URL Scheme?

    2023-12-18
    赞同 2
    回复 2
  • 活动拓客_六
    活动拓客_六
    01-12

    是来搞笑的吗?

    01-12
    赞同 1
    回复 1
    • 地球炒蛋
      地球炒蛋
      01-30
      请问你解决这个问题了吗
      01-30
      回复
  • 哄哄
    哄哄
    2023-12-28

    微信终于干了回人事儿了!

    2023-12-28
    赞同 1
    回复
  • 哄哄
    哄哄
    2023-12-21

    小米手机测了好多遍都打不开

    2023-12-21
    赞同 1
    回复 2
    • 神经蛙
      神经蛙
      2023-12-25
      只有在Android微信内才会有问题,不影响外部场景打开,微信官方也会尽快修复。
      2023-12-25
      回复
    • 地球炒蛋
      地球炒蛋
      01-30回复神经蛙
      iphone 12 pro出现了这个问题
      01-30
      回复
  • 只做自己🍀
    只做自己🍀
    发表于小程序端
    2023-12-21

    123

    2023-12-21
    赞同 1
    回复
  • 吊儿郎当
    吊儿郎当
    2023-12-20
    获取小程序url scheme 接口报系统错误(system error

    接口:https://api.weixin.qq.com/wxa/generatescheme?access_token=75_L***4r3

    content: 2023-12-20 18:27:50.113 [DubboServerHandler-17****4:20880-thread-599] [TID:a7ccc9fedf014f538946666b98ca8385.85.17030680698356121] [] INFO  [HttpRestTemplateUtil.java:78] - resttemplate-http-response | reqId:42628552852114786 | url:https://api.weixin.qq.com/wxa/generatescheme?acce***ken=75_LX3b****ADAXXR | responseEntity:{"headers":{"LogicRet":["-1"],"Connection":["keep-alive"],"RetKey":["11"],"Date":["Wed, 20 Dec 2023 10:27:50 GMT"],"Content-Length":["70"],"Content-Type":["application/json; encoding=utf-8"]},"body":"{\"errcode\":-1,\"errmsg\":\"system error rid: 6582c1a6-5346803f-3b7c71de\"}"} | time:126
    
    2023-12-20
    赞同 1
    回复
  • ZERO To ONE
    ZERO To ONE
    2023-12-20

    NB

    2023-12-20
    赞同 1
    回复
  • laohan
    laohan
    2023-12-20

    我根据这个来配置的路径在微信里面访问不了呀,小程序已经上线,后台也配置了那个明文scheme拉起此小程序

    2023-12-20
    赞同 1
    回复 8
    • yetta
      yetta
      2023-12-20
      在微信外可以拉起小程序吗?
      2023-12-20
      1
      回复
    • 🌚🌝
      🌚🌝
      2023-12-21
      后台配置的pages/index/index, 
      weixin://dl/business/?appid=*APPID*&path=*PATH*&query=*QUERY*&env_version=*ENV_VERSION*
      这里面的path 也要是pages/index/index 不能是 /pages/index/index
      2023-12-21
      1
      回复
    • 顺其自然
      顺其自然
      2023-12-21回复🌚🌝
      我query为啥只能拿到第一个参数 第二个拿不到 query=a=123&b=456  只能拿到a的数据
      2023-12-21
      回复
    • laohan
      laohan
      2023-12-22回复🌚🌝
      2023-12-22
      回复
    • laohan
      laohan
      2023-12-22回复laohan
      配置应该是没得问题的吧
      2023-12-22
      回复
    查看更多(3)
  • 云灰灰
    云灰灰
    2023-12-20

    安卓 location.href= scheme 地址 无法直接跳转

    2023-12-20
    赞同 1
    回复 1
    • 云灰灰
      云灰灰
      2023-12-20
      安卓在微信直接打开H5带上跳转scheme的代码 ,不能直接打开小程序
      2023-12-20
      1
      回复

正在加载...

登录 后发表内容