浏览器HTML5页面或短信链接如何调用唤起微信小程序（URL Scheme）？_html5

介绍

背景：用于实现外部h5页面中实现打开微信小程序的功能(微信内打开请使用微信开放标签方式)，用户在网页中一键唤起小程序，能够给用户提供更好的体验。采用的技术是url scheme，是微信小程序后台生成一种地址，适用于从短信、邮件、微信外网页等场景打开小程序任意页面，即点击微信外部链接，唤起微信，打开中转页面，从中转页面进入小程序。通过url scheme打开小程序的场景值为 1065。
整体思路：前端调用后端接口，后端调用微信接口生成url scheme返回给前端，前端得到url scheme后，打开该链接即可实现跳转
生成的 url scheme 如下所示

location.href = 'weixin://dl/business/?t=sagndxoluds'

获取 url scheme

自 2023 年 12 月 19 日起，对url scheme进行升级，详细调整说明可见《url scheme 和 url link优化公告》。改动点概览如下：

支持开发者在原有加密 url scheme 后面拼接参数；

新增明文 url scheme，开发者无需调用接口可自行拼接生成明文scheme；

取消 url scheme 一人一链的限制，支持同一条连接被多名用户访问；

每个小程序每天 url scheme 和 url link 总打开次数上限为300万。

操作步骤

开发前的准备工作

必须是企业的小程序

获取appid，也就是小程序唯一凭证，可在微信公众平台 - 设置 - 开发设置」页中获得。（需要已经成为开发者，且帐号没有异常状态）
获取appsecret，也就是小程序唯一凭证密钥

关于url scheme
微信官方文档：https://developers.weixin.qq.com/miniprogram/dev/framework/open-ability/url-scheme.html
后端

代码逻辑：后端调用微信接口获取access_token，在用获取access_token去调用微信接口生成url scheme，在将url scheme返回给前端

获取access_token

微信官方文档https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/access-token/auth.getaccesstoken.html

请求地址

get https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid=appid&secret=appsecret

参数列表：

参数	含义
grant_type	固定为client_credential
appid	小程序唯一凭证，即 appid
secret	小程序唯一凭证密钥，即 appsecret

得到以下数据说明成功：

{"access_token": "56_iut0umy6*********wertaahavik", "expires_in": 7200}

生成url scheme

微信官方文档：https://developers.weixin.qq.com/miniprogram/dev/api-backend/open-api/url-scheme/urlscheme.generate.html

请求地址

post https://api.weixin.qq.com/wxa/generatescheme?access_token=access_token

参数列表：

参数	含义
access_token	接口凭证

得到以下数据说明成功：

{
    "errcode": 0,
    "errmsg": "ok",
    "openlink": "weixin://dl/business/?t=sagndxoluds"
}

此时已经拿到了openlink ，也就是url scheme，将该信息返回前端即可

前端
请求后端接口拿到url scheme，然后已url形式打开即可，该方式仅支持手机浏览器，如果是微信浏览器则需要使用(微信开放标签)方式

<a href="weixin://dl/business/?t=sagndxoluds" rel="external nofollow" >打开小程序</a>

href 绑定的是 url scheme 地址。

备注笔记

频率限制

生成端：每天生成 url scheme（加密+明文）和 url link 的总数量上限为50万；

打开端：每天通过 url scheme（加密+明文）和 url link 打开小程序的总次数上限为300万。

注意事项

微信内的网页如需打开小程序请使用微信开放标签-小程序跳转按钮，无公众号也可以直接使用小程序身份开发网页并免鉴权跳转小程序，见云开发静态网站跳转小程序。符合开放范围的小程序可以下发支持打开小程序的短信
该功能基本覆盖当前用户正在使用的微信版本，开发者无需进行低版本兼容
只能生成已发布的小程序的 url scheme
通过 url scheme 跳转到微信时，可能会触发系统弹框询问，若用户选择不跳转，则无法打开小程序。请开发者妥善处理用户选择不跳转的场景
部分浏览器会限制打开网页直接跳转，可参考示例网页设置跳转按钮
平台有安全策略防止开发者的链接被黑灰产批量打开，导致的达到访问上限无法正常打开小程序的问题