微信小程序 ---- 从短信、邮件、微信外网页等场景打开小程序

测试地址

复制地址到短信、邮件、或者其他浏览器：http://read.yajunliang.com/quanyi

1. 文档

《URL Scheme打开小程序》

2. 《获取 access_token》

1. 请求地址

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

2. 请求参数

属性	类型	默认值	必填	说明
grant_type	string		是	填写 client_credential
appid	string		是	小程序唯一凭证，即 AppID，可在「微信公众平台 - 设置 - 开发设置」页中获得。（需要已经成为开发者，且帐号没有异常状态）
secret	string		是	小程序唯一凭证密钥，即 AppSecret，获取方式同 appid

3. 返回值

属性	类型	说明
access_token	string	获取到的凭证
expires_in	number	凭证有效时间，单位：秒。目前是7200秒之内的值。
errcode	number	错误码
errmsg	string	错误信息

3. 《生成的小程序scheme码》

1. 请求地址

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

2. 请求参数

属性	类型	默认值	必填	说明
access_token	string		是	接口调用凭证
jump_wxa	Object		否	跳转到的目标小程序信息。
is_expire	boolean	false	否	生成的scheme码类型，到期失效：true，永久有效：false。
expire_time	number		否	到期失效的scheme码的失效时间，为Unix时间戳。生成的到期失效scheme码在该时间前有效。生成到期失效的scheme时必填。

3. jump_wxa 的结构

属性	类型	默认值	必填	说明
path	string		是	通过scheme码进入的小程序页面路径，必须是已经发布的小程序存在的页面，不可携带query。path为空时会跳转小程序主页。
query	string		是	通过scheme码进入小程序时的query，最大128个字符，只支持数字，大小写英文以及部分特殊字符：!#$&’()*+,/:;=?@-._~

4. openlink

生成的小程序scheme码

4. 《URL Scheme打开小程序》

通过服务端接口可以获取打开小程序任意页面的URL Scheme。适用于从短信、邮件、微信外网页等场景打开小程序。通过URL Scheme打开小程序的场景值为 1065。

1. 生成的URL Scheme如下所示：

weixin://dl/business/?t= TICKET

2. iOS系统支持识别URL Scheme，可在短信等应用场景中直接通过Scheme跳转小程序。
   Android系统不支持直接识别URL Scheme，用户无法通过Scheme正常打开小程序，开发者需要使用H5页面中转，再跳转到Scheme实现打开小程序，跳转代码示例如下：

location.href = ‘weixin://dl/business/?t= TICKET’

该跳转方法可以在用户打开H5时立即调用，也可以在用户触发事件后调用。

3. 调用上限

Scheme将根据是否为到期有效与失效时间参数，分为短期有效Scheme与长期有效Scheme：

3.1 有效时间不超过31天的Scheme为短期有效Scheme，单个小程序每日生成短期有效Scheme上限为50万个
3.2 有效时间超过31天的Scheme或永久有效的Scheme为长期有效Scheme，单个小程序总共可生成长期有效Scheme上限为10万个，请谨慎调用

4. 注意事项

4.1生成的URL Scheme仅支持从微信外打开小程序。微信内的网页如需打开小程序请使用微信开放标签-小程序跳转按钮，无公众号也可以直接使用小程序身份开发网页并免鉴权跳转小程序，见云开发静态网站跳转小程序。符合开放范围的小程序可以下发支持打开小程序的短信。
4.2 该功能基本覆盖当前用户正在使用的微信版本，开发者无需进行低版本兼容。
4.3 只能生成已发布的小程序的URL Scheme。
4.4 通过URL Scheme跳转到微信时，可能会触发系统弹框询问，若用户选择不跳转，则无法打开小程序。请开发者妥善处理用户选择不跳转的场景。

5. 开放范围

针对国内非个人主体小程序开放。

WXRUI体验二维码

如果文章对你有帮助的话，请打开微信扫一下二维码，点击一下广告，支持一下作者！谢谢！

下载

我的博客，欢迎交流！

我的CSDN博客，欢迎交流！

微信小程序专栏

前端笔记专栏

微信小程序实现部分高德地图功能的DEMO下载

微信小程序实现MUI的部分效果的DEMO下载

微信小程序实现MUI的GIT项目地址

微信小程序实例列表

前端笔记列表

游戏列表

我的博客即将同步至腾讯云+社区，邀请大家一同入驻：https://cloud.tencent.com/developer/support-plan?invite_code=3mtizdervp2c8