生成 小程序 URL Scheme

Posted 2023-03-30 mr_cmx

一、获取 access_token

auth.getAccessToken

获取小程序全局唯一后台接口调用凭据（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

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":"ACCESS_TOKEN","expires_in":7200

官方文档 >>

二、获取小程序 scheme 码

urlscheme.generate

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

请求地址

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

成功时返回示例：

官方文档 >>

官方上对API请求的传参方式 说得并不清晰。这里有几个要注意的点：

1、在请求时传参方式并不是键值 多参形式，而是例如下面的 单个 json字符串

	"jump_wxa":
	
		"path": "/pages/index/index",
		"query": "arg=1",
		"env_version":"develop"
	,
	"expire_type":1,
	"expire_interval":1

2、页面带参（query）
如果要给page带参不能像平常一样在路径上拼接："/pages/index/index?arg=1",这会直接报路径错误。
正常的写法应该是作为另外一个参数 ："query": "arg=1"

---

如果返回47001就说明请求数据格式不对

转载请标明 原文地址

小程序的「获取URL Scheme」能力

参考技术A 最近，微信小程序更新了一项新的能力：「获取URL Scheme」，这是一项非常有用的功能，你可以借助他，在微信生态中实现各种有意思的营销方式。

微信提供了一个接口，可以生成如 weixin://dl/business/?t= *TICKET* 的 URL Scheme。你可以在系统自带的浏览器，比如 Safari 中访问这个地址，自动跳转到你自己的微信小程序中。

URL Scheme 的用途最大自然是各种营销用途，比如短信营销。不过，如果我们发散思维，就可以知道，URL Scheme 可以有更多的用途。

URL Scheme 在 iOS 系统应用中是比较多的，不少 iOS 的 Power User 都会借助 URL Scheme 来自定义自己的手机中的一些操作，实现特别的操作。我们可以参考 iOS 的 Power User 的用法，理解微信的 URL Scheme 的用法

如果我们将这些能力迁移到微信生态中，就可以发现，这里我们同样可以实现：

虽然很好，不过 URL Scheme 目前还有一些问题，比如只限于国内非个人主体小程序，对于个人开发者来说就无法使用了。

URL Scheme 的开放，对于微信生态来说，是一个很有力的工具，开发者可以借助与 URL Scheme 来完成自己在微信生态中的推广。在未来，我们可以看到，越来越多的开发者借助于 URL Scheme ，来实现一些很有意思的营销方式。