微信小程序 ---- 通过 URLScheme 或 URLLink 从短信、邮件、微信外网页等场景打开小程序

1. 用于短信、邮件、网页、微信内等拉起小程序的方法

1. 《URL Scheme 拉起小程序》
2. 《URL Link 拉起小程序》

2. 功能描述

1. URL Scheme: 该接口用于获取小程序 scheme 码，适用于短信、邮件、外部网页、微信内等拉起小程序的业务场景。目前仅针对国内非个人主体的小程序开放，详见获取 URL scheme。
2. URL Link: 获取小程序 URL Link，适用于短信、邮件、网页、微信内等拉起小程序的业务场景。目前仅针对国内非个人主体的小程序开放，详见获取 URL Link。

3. 调用上限

1. 生成端：每天生成 URL Scheme（加密 明文） 和 URL Link 的总数量上限为50万；
2. 打开端：每天通过 URL Scheme（加密 明文） 和 URL Link 打开小程序的总次数上限为300万；
3. 自 2023 年 12 月 19 日起，取消 URL Scheme 一人一链的限制，支持同一条连接被多名用户访问。详细调整说明可见《URL Scheme 和 URL Link优化公告》。

4. 其他注意事项

4.1 URL Scheme

1. 加密 URL Scheme 支持开发者自行在链接后面拼接 query 参数，详见获取 URL Scheme；
2. 微信内的网页如需打开小程序请使用微信开放标签-小程序跳转按钮，无公众号也可以直接使用小程序身份开发网页并免鉴权跳转小程序，见云开发静态网站跳转小程序。符合开放范围的小程序可以下发支持打开小程序的短信；
3. 该功能基本覆盖当前用户正在使用的微信版本，开发者无需进行低版本兼容；
4. 只能生成已发布的小程序的 URL Scheme；
5. 通过 URL Scheme 跳转到微信时，可能会触发系统弹框询问，若用户选择不跳转，则无法打开小程序。请开发者妥善处理用户选择不跳转的场景；
6. 部分浏览器会限制打开网页直接跳转，可参考示例网页设置跳转按钮。

4.2 URL Link

1. 加密 URL Link 支持开发者自行在链接后面拼接 query 参数，详见获取 URL Link；
2. 只能生成已发布的小程序的 URL Link；
3. 在微信内或者安卓手机打开 URL Link 时，默认会先跳转官方 H5 中间页，如果需要定制 H5 内容，可以使用云开发静态网站。

5. 调用方式

5.1 HTTPS 调用

1. URL Scheme：POST https://api.weixin.qq.com/wxa/generatescheme?access_token=ACCESS_TOKEN；
2. URL Link：POST https://api.weixin.qq.com/wxa/generate_urllink?access_token=ACCESS_TOKEN。

5.2 云调用

1. URL Scheme：接口方法为: openapi.urlscheme.generate；
2. URL Link：接口方法为: openapi.urllink.generate。

5.3 第三方调用

1. URL Scheme

1. 调用方式以及出入参和HTTPS相同，仅是调用的token不同；
2. 该接口所属的权限集id为：88、115；
3. 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用。

2. URL Link

1. 调用方式以及出入参和HTTPS相同，仅是调用的token不同；
2. 该接口所属的权限集id为：88、115；
3. 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用。

6. 请求参数

6.1 URL Scheme

1. 参数说明

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
jump_wxa	Object		否	跳转到的目标小程序信息。
expire_time	number		否	到期失效的 scheme 码的失效时间，为 Unix 时间戳。生成的到期失效 scheme 码在该时间前有效。最长有效期为30天。is_expire 为 true 且 expire_type 为 0 时必填
expire_type	number		否	默认值0，到期失效的 scheme 码失效类型，失效时间：0，失效间隔天数：1
expire_interval	number		否	到期失效的 scheme 码的失效间隔天数。生成的到期失效 scheme 码在该间隔时间到达前有效。最长间隔天数为30天。is_expire 为 true 且 expire_type 为 1 时必填。

2. jump_wxa 说明

属性	类型	默认值	必填	说明
path	string		否	通过 scheme 码进入的小程序页面路径，必须是已经发布的小程序存在的页面，不可携带 query。path 为空时会跳转小程序主页。
query	string		否	通过 scheme 码进入小程序时的 query，最大1024个字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~%`
env_version	string		否	默认值"release"。要打开的小程序版本。正式版为"release"，体验版为"trial"，开发版为"develop"，仅在微信外打开时生效。

6.2 URL Link

1. 参数说明

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
path	string		否	通过 URL Link 进入的小程序页面路径，必须是已经发布的小程序存在的页面，不可携带 query 。path 为空时会跳转小程序主页。
query	string		否	通过 URL Link 进入小程序时的query，最大1024个字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~%
expire_time	number		否	到期失效的 URL Link 的失效时间，为 Unix 时间戳。生成的到期失效 URL Link 在该时间前有效。最长有效期为30天。expire_type 为 0 必填
expire_type	number		否	默认值0.小程序 URL Link 失效类型，失效时间：0，失效间隔天数：1
expire_interval	number		否	到期失效的URL Link的失效间隔天数。生成的到期失效URL Link在该间隔时间到达前有效。最长间隔天数为30天。expire_type 为 1 必填
cloud_base	object		否	云开发静态网站自定义 H5 配置参数，可配置中转的云开发 H5 页面。不填默认用官方 H5 页面
env_version	string		否	默认值"release"。要打开的小程序版本。正式版为 “release”，体验版为"trial"，开发版为"develop"，仅在微信外打开时生效。

3. cloud_base 说明

属性	类型	默认值	必填	说明
env	string		是	云开发环境
domain	string		否	静态网站自定义域名，不填则使用默认域名
path	string		否	云开发静态网站 H5 页面路径，不可携带 query
query	string		否	云开发静态网站 H5 页面 query 参数，最大 1024 个字符，只支持数字，大小写英文以及部分特殊字符：!#$&'()*+,/:;=?@-._~%`
resource_appid	string		否	第三方批量代云开发时必填，表示创建该 env 的 appid （小程序/第三方平台）

7. 注意

部分 URL Link 返回的 url_link，在QQ浏览器会被拦截！！！，因此目前我还是使用的 URL Scheme！！！