微信外唤起微信小程序的方法详解

小程序启动

目标：实现微信环境内的长按扫码跳转功能

0. 接口访问凭证

auth.getAccessToken

此接口需在服务端执行，具体参考服务端API文档。

获取小程序后台唯一接口调用凭据（access_token）。调用大部分后台接口均需 access_token，开发者须妥善保管。若使用云开发，可通过云调用免维护 access_token。若使用云托管，亦可通过微信令牌或开放接口服务免维护 access_token。

请求地址

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

请求参数

返回结果

Object 返回的 JSON 数据包

errcode 的有效值列表

返回数据示例

成功返回

{"access_token":"ACCESS_TOKEN","expires_in":7200}

失败时返回

{"errcode":40013,"errmsg":"invalid appid"}

access_token 的存储与更新策略

• access_token 的存储空间至少需保留 512 个字符；
• access_token 当前有效期为 2 小时，需定期刷新，重复获取会导致前次获取的 access_token 失效；
• 建议开发者通过中控服务器统一获取和刷新 access_token，其他业务逻辑服务器所用 access_token 均源自该中控服务器，不应各自刷新，以免引发冲突导致 access_token 被覆盖而影响业务；
• access_token 的有效期由返回的 expires_in 告知，目前为 7200 秒内的值，中控服务器需据此提前刷新。刷新期间，中控服务器可继续输出旧 access_token，公众平台后台保证 5 分钟内新老 access_token 均有效，确保第三方业务平滑过渡；
• access_token 的有效期未来可能调整，因此中控服务器除内部定时主动刷新外，还需提供被动刷新 access_token 接口，以便业务服务器在 API 调用获知 access_token 已超时时，能触发 access_token 的刷新流程。

详情请参考微信公众平台文档《获取access_token》

1.生成链接

urllink.generate

此接口需在服务端执行，具体参考服务端API文档。

此接口支持云调用。需开发者工具版本 >= 1.02.1904090（最新稳定版下载），wx-server-sdk >= 0.4.0

获取小程序 URL Link，适用于短信、邮件、网页、微信内等拉起小程序的业务场景。通过该接口，可以选择生成到期失效和永久有效的小程序链接，有数量限制，目前仅针对国内非个人主体的小程序开放，详见获取 URL Link

调用方式：

• HTTPS 调用
• 云调用

HTTPS 调用

请求地址

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

请求参数

cloud_base 的结构

返回值

url_link

生成的小程序 URL Link

返回值说明

如果调用成功，会直接返回生成的小程序 URL Link。如果请求失败，会返回 JSON 格式的数据。

示例

请求

{
    "path": "/pages/publishHomework/publishHomework",
    "query": "",
    "is_expire":true,
    "expire_type":1,
    "expire_interval":1,
    "env_version": "release",
    "cloud_base":
    {
        "env": "xxx",
        "domain": "xxx.xx",
        "path": "/jump-wxa.html",
        "query": "a=1&b=2"
    }
}

返回

{
 "errcode": 0,
 "errmsg": "ok",
 "url_link": "URL Link"
}

2.1 唤起小程序：URL Scheme

通过服务端接口或在小程序管理后台「工具」-「生成 URL Scheme」入口可以获取打开小程序任意页面的 URL Scheme。适用于从短信、邮件、微信外网页等场景打开小程序。 通过 URL Scheme 打开小程序的场景值为 1065。 生成的 URL Scheme 如下所示：

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

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

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

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

调用上限

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

1. 单个小程序每日生成 Scheme 上限为50万个（包含短期有效 Scheme 与长期有效 Scheme）
2. 有效时间超过180天的 Scheme 或永久有效的 Scheme 为长期有效Scheme，单个小程序总共可生成长期有效 Scheme 上限为10万个，请谨慎调用
3. 有效时间不超过180天的 Scheme 为短期有效Scheme，单个小程序生成短期有效 Scheme 不设上限

2.2 唤起小程序：URL Link

通过服务端接口可以获取打开小程序任意页面的 URL Link。适用于从短信、邮件、网页、微信内等场景打开小程序。 通过 URL Link 打开小程序的场景值为 1194。 生成的 URL Link 如下所示：

https://wxaurl.cn/*TICKET* 或 https://wxmpurl.cn/*TICKET*

调用上限

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

1. 单个小程序每日生成 Link 上限为50万个（包含短期有效 Link 与长期有效 Link ）
2. 有效时间超过180天的 Link 或永久有效的 Link 为长期有效Link，单个小程序总共可生成长期有效 Link 上限为10万个，请谨慎调用
3. 有效时间不超过180天的 Link 为短期有效Link，单个小程序生成短期有效 Link 不设上限

注意事项

1. 只能生成已发布的小程序的 URL Link。
2. 在微信内或者安卓手机打开 URL Link 时，默认会先跳转官方 H5 中间页，如果需要定制 H5 内容，可以使用云开发静态网站。

示例代码

默认官方 H5 示例地址：https://wxaurl.cn/pFawq35qbfd

自定义 H5 示例地址：https://wxaurl.cn/GI7aI2G1otd

兼容性

记录在IOS、安卓环境下各应用调起小程序的情况

相关链接

urlscheme.generate | 微信开放文档 获取 URL Link | 微信开放文档 获取 URL Scheme | 微信开放文档