我们在开发网站的时候,可能会遇到下面的一些需求:网站跳转微信小程序;比如说公司的官网想实现跳转到微信小程序,那么有没有相应的接口实现呢?答案当然是有的,但是这个功能只限于认证后的小程序,所以此功能对个人开发者的小程序不支持,具体可看获取 URL Scheme、urlscheme.generate-获取小程序 scheme 码。
目录
微信在外部网站点击小程序链接后的效果图
当在h5链接中点击跳转小程序的a标签后,会有如下提示,并不是直接跳转。在外部浏览器打开时,会提示打开微信。
小程序官网文档的介绍
urlscheme.generate
本接口应在服务器端调用,详细说明参见服务端API。
本接口支持云调用。需开发者工具版本 >=
1.02.1904090
(最新稳定版下载),wx-server-sdk
>=0.4.0
获取小程序 scheme 码,适用于短信、邮件、外部网页、微信内等拉起小程序的业务场景。目前仅针对国内非个人主体的小程序开放,详见获取 URL scheme。
调用方式:
可见此接口支持自建后端调用和云调用,本篇博文只实现PHP后端调用。
继续查看官方文档:
HTTPS 调用
请求地址
POST https://api.weixin.qq.com/wxa/generatescheme?access_token=ACCESS_TOKEN
请求参数
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
access_token / cloudbase_access_token | string | 是 | 接口调用凭证 | |
jump_wxa | Object | 是 | 跳转到的目标小程序信息。 | |
expire_type | number | 是 | 到期失效的 scheme 码失效类型,失效时间:0,失效间隔天数:1 | |
expire_time | number | 否 | 到期失效的 scheme 码的失效时间,为 Unix 时间戳。生成的到期失效 scheme 码在该时间前有效。最长有效期为30天。expire_type 为 0 时必填 | |
expire_interval | number | 否 | 到期失效的 scheme 码的失效间隔天数。生成的到期失效 scheme 码在该间隔时间到达前有效。最长间隔天数为30天。 expire_type 为 1 时必填 |
jump_wxa 的结构
属性 | 类型 | 默认值 | 必填 | 说明 |
---|---|---|---|---|
path | string | 否 | 通过 scheme 码进入的小程序页面路径,必须是已经发布的小程序存在的页面,不可携带 query。path 为空时会跳转小程序主页。 | |
query | string | 否 | 通过 scheme 码进入小程序时的 query,最大1024个字符,只支持数字,大小写英文以及部分特殊字符:`!#$&'()*+,/:;=?@-._~%`` | |
env_version | string | "release" | 否 | 要打开的小程序版本。正式版为"release",体验版为"trial",开发版为"develop",仅在微信外打开时生效。 |
关于token的获取,在下文的token类中的tk()方法有实现,需要小程序的appid和小程序的secret密钥这两个字符串。然后需要将此token存入redis,避免重复获取导致其他的功能失效。
然后有两个参数,失效间隔天数和失效时间,此参数根据自己需求填写即可,切记不能两个同时填写。
再是jump_wxa里面的数据,path填写正确的路径即可,如果不填写就会跳转到主页。然后query是参数,根据业务需求填写即可。最后是env_version,在调试时填写develop(开发版),小程序正式发布之后改为release(正式版),或者留空。
我们获取到外部网站跳转小程序的链接之后,可以直接通过header()方法直接跳转。
新建一个token.php文件
connect('127.0.0.1', 6379); $appletToken = $redis->exists("appletToken"); if ($appletToken==0){ $url = "https://api.weixin.qq.com/cgi-bin/token?grant_type=client_credential&appid={$appid}&secret={$secret}"; $res = file_get_contents($url); $redis->set("appletToken",json_decode($res)->access_token); $redis->expire("appletToken","7200"); } return $redis->get("appletToken"); } function urlscheme(){ $token = $this->tk(); $url1 = 'https://api.weixin.qq.com/wxa/generatescheme?access_token='.$token; $ch = curl_init(); $data1 = array("path"=>"", "query"=>"","env_version"=>"release"); $data = json_encode(array("expire_type"=>1,"expire_interval"=>5,"jump_wxa"=>$data1)); curl_setopt($ch, CURLOPT_URL, $url1); curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST"); curl_setopt($ch, CURLOPT_POSTFIELDS, $data); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); $output = curl_exec($ch); curl_close($ch); return $output; }}
新建一个Jump.php文件实现跳转小程序
urlscheme();$Jump = json_decode($urlscheme)->openlink;header("Location: {$Jump}");
直接访问此php文件即可实现小程序的跳转。
来源地址:https://blog.csdn.net/qq_41021581/article/details/126991975