要把用户从短信、邮件或微信外的网页拉进小程序,有人会把「URL Scheme」当成必须调用服务端接口才能拿到的一串地址;也有人看见文档里给出了 weixin:// 开头的格式,就以为可以随便按样子拼一条出来,不必再看有没有声明、是明文还是加密。2026年11月21日(北京时间)阅读的微信开放文档《获取 URL Scheme》(页标最后一次编辑于 2026-06-16)把获取方式分成两种:明文 URL Scheme,开发者无需调用平台接口,在指定位置完成声明后,可按官方格式自行拼接;加密 URL Scheme,通过服务端接口获取。以下只转述

该页已经写出的获取方式、声明位置、参数定义、场景值和注意事项。本文不是完整的接入教程,也不把明文 Scheme 写成普通传播短链,更不证明任何第三方工具已经接入这些接口。
该页在正文里并排写了「明文 URL Scheme」和「加密 URL Scheme」两节,各自有「获取方式」。这两种方式都叫 URL Scheme,但获取路径不同,打开后的场景值也不同:明文为 1286,加密为 1065。
页首还写:每个小程序每天 URL Scheme 和 URL Link 总打开次数上限为 600 万。「频率限制」一节又写:生成端每天生成加密 URL Scheme 和 URL Link 的总数量上限为 50 万;打开端每天通过 URL Scheme(加密+明文)和 URL Link 打开小程序的总次数上限为 600 万。开放范围写的是:针对非个人主体小程序开放。这些是两种方式共同面对的范围和上限,不能用来把两种获取方式收成同一步,本题也不把次数上限重新写成另一篇计算说明。
要回答「明文可不可以自己拼接、是不是必须调接口」,先回到这两节各自写明的获取方式,而不是先去套用加密接口或普通短链的做法。
明文这一节的获取方式原文是:开发者无需调用平台接口,在「MP平台 - 左下角账号 - 账号设置 - 基本设置 - 隐私与安全 - 明文Scheme拉起此小程序」声明后,可自行根据如下格式拼接 appid 和 path 等参数,作为明文 URL Scheme 链接。
官方给出的格式是:weixin://dl/business/?appid=APPID&path=PATH&query=QUERY&env_version=ENV_VERSION
参数定义也写在同一节。【必填】APPID:通过明文 URL Scheme 打开小程序的 appid。【必填】PATH:通过明文 URL Scheme 打开小程序的页面 path,必须是已经发布的小程序存在的页面,不可携带 query。【选填】QUERY:通过明文 URL Scheme 打开小程序的 query,最大 512 个字符,只支持数字、大小写英文以及官方列出的部分特殊字符,需要做 url_encode。【选填】ENV_VERSION:要打开的小程序版本,正式版为 release,体验版为 trial,开发版为 develop,仅在微信外打开时生效;若不填写,则默认打开正式版小程序。通过明文 URL Scheme 打开小程序的场景值为 1286。
按这些句子,明文 Scheme 的关键有两层:一层是「无需调用平台接口」,允许按格式自行拼接;另一层是拼接之前,要先在官方写明的 MP 平台位置完成声明。页面没有把「可以自行拼接」写成「不必声明」或「格式可以随意改」。PATH 必须是已经发布的页面,也不得把 query 写进 path。超出页上已经列出的参数含义,本文不补后台截图或操作步骤。
加密这一节的获取方式原文是:通过服务端接口可以获取打开小程序任意页面的加密 URL Scheme。它写明适用于从短信、邮件、微信外网页等场景打开小程序,通过 URL Scheme 打开小程序的场景值为 1065。生成的格式是:weixin://dl/business/?t= TICKET
和明文相比,这里没有写「自行根据格式拼接 appid 和 path」,而是要取得票证形式的加密 Scheme。该节还写:iOS 系统支持识别 URL Scheme,可在短信等应用场景中直接通过 Scheme 跳转小程序;Android 系统不支持直接识别 URL Scheme,用户无法通过 Scheme 正常打开小程序,开发者需要使用 H5 页面中转,再跳转到 Scheme 实现打开小程序。安卓要先走网页,以及打开次数、有效期等,已是另一类核对,本题只在说明加密获取方式时点到官方原文,不展开成短信或浏览器打开的完整说明。
同一节下另有「拼接参数」,说的是将原有 URL Scheme 平滑升级为加密 URL Scheme,支持开发者自行在链接后面拼接参数。这是加密 Scheme 拿到之后如何附加参数,不是明文 Scheme 的获取方式,也不是「必须调接口还是可以自己拼接」的主线,本文不把它写成参数规则教程。
两种方式除了获取路径不同,还要按页上已经写出的参数和注意事项来核对,避免把明文的可拼接格式套到加密票证上,或把加密接口的结果理解成自己就可以改 appid 和 path。
明文这边,必须出现的是 appid 和 path,query 与 env_version 是选填;path 必须是已发布页面且不可携带 query;明文打开的场景值是 1286。加密这边,页上展示的是带票证的格式,打开场景值是 1065;它写的是通过服务端接口获取,并适用于短信、邮件、微信外网页等场景。
「注意事项」还写了若干对 URL Scheme 的共同约束,其中包括:只能生成已发布的小程序的 URL Scheme;通过 URL Scheme 跳转到微信时,可能会触发系统弹框询问,若用户选择不跳转,则无法打开小程序;部分浏览器会限制打开网页直接跳转;微信内的网页如需打开小程序,请使用微信开放标签中的小程序跳转按钮。这些是页上已经点名的注意点,不是某一种获取方式可以忽略的附加项,但本文也不把它们改写成逐步点击的操作指南。
「只能生成已发布的小程序的 URL Scheme」,和明文参数里「path 必须是已经发布的小程序存在的页面」,都指向已经发布这一前提。页上没有另写未发布小程序可以怎样例外,本文也不补例外。
要判断明文 URL Scheme 可以自己拼接还是必须调接口,可以按该页已经写出的层次来核对。
第一,官方明确分成明文、加密两种获取方式,场景值分别是 1286 和 1065,不能收成同一种获取步骤。
第二,明文无需调用平台接口,但要先在「MP平台 - 左下角账号 - 账号设置 - 基本设置 - 隐私与安全 - 明文Scheme拉起此小程序」完成声明,再按官方格式自行拼接 appid、path 等参数。
第三,加密通过服务端接口获取,页上给出的是带票证的格式,并写明安卓不支持直接识别、需要 H5 中转。这与明文的自行拼接不是同一条路径。
第四,次数上限、开放范围和注意事项是页上已经写出的共同约束,可在核对时一并查看,但不要把它们理解成「因此两种方式可以互相代替」。
第五,明文 Scheme 仍然是官方文档中的小程序拉起链接,不能把它写成普通传播用的短链,也不能在未核实接入关系时,把第三方短链工具写成已经提供或未提供这一能力。
本文依据的是 2026年11月21日(北京时间)阅读的《获取 URL Scheme》现有表述,未登录微信公众平台,也未调用生成或打开接口做实测。声明开关在管理端如何展示、未声明时自行拼接会怎样、加密接口的请求字段和返回细节,该页在本题范围内没有写成可照做的步骤,这些都仍未核实。最终只能以当时页面已经写出的两种获取方式为准。
获取 URL Scheme https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html (页标最后一次编辑于 2026-06-16,2026年11月21日北京时间阅读)
