掃二維碼與項目經理溝通
我們在微信上24小時期待你的聲音
解答本文疑問/技術咨詢/運營咨詢/技術建議/互聯(lián)網交流
URL scheme是App提供給外部的可以直接操作App的規(guī)則,場景的手機app都會定義自己的URL Scheme規(guī)則,如淘寶的taobao://,微信的weixin://。主要用于不同app之間進行跳轉,當然也可以從網頁跳轉到app,跟網頁的超鏈接跳轉作用是類似的。
需要說明的是,生成的URL scheme只能被一個用戶打開(同一個用戶可以重復打開),如果一個鏈接被用戶打開過,其他用戶打開會報錯。同時,單天生成Scheme+URL Link數(shù)量上限是50萬條。目前該功能僅對非個人小程序賬號開放權限,也就是以個人身份注冊的小程序不能使用該接口能力。
自 2022 年 4 月 11 日起,URL Scheme有效期最長 30 天,不再支持永久有效的URL Scheme、不再區(qū)分短期有效URL Scheme與長期有效URL Scheme。
請求地址
https://api.weixin.qq.com/wxa/generatescheme?access_token=ACCESS_TOKEN
其中ACCESS_TOKEN就是通過getAccessToken獲取的access_token(有效期為2個小時,可以緩存),也就是這樣的信息:
57_ojAsr9tfw8gYoFuSN8XFeuHFGLOScdq75sZL4qVTnUF_YPxiJdJEPiPH1JB9NFxv3OsvTjTtcRf3aNMTl1BEAcZbBmPzCsuYoZYuXQtx8V11w68XtcuzRNC692aWZCXdIAj_8Zd1-N8ebMfo****ABAOFB
請求參數(shù)如下:
一般的我們需要jump_wxa的的參數(shù),如果不設置,則自動跳轉到小程序設置的主頁,jump_wxa包括如下參數(shù):
1、path:通過 scheme 碼進入的小程序頁面路徑,必須是已經發(fā)布的小程序存在的頁面,不可攜帶 query。path 為空時會跳轉小程序主頁(如/pages/index/index);
2、query:通過 scheme 碼進入小程序時的 query(也就是小程序頁面的參數(shù)),最大1024個字符,只支持數(shù)字,大小寫英文以及部分特殊字符:`!#$&’()*+,/:;=?@-._~%“;
3、env_version:要打開的小程序版本。正式版為”release”,體驗版為”trial”,開發(fā)版為”develop”,僅在微信外打開時生效。默認為“release”(也就是正式版)。
簡單的服務端demo代碼如下:
?$jssdk = new \jssdk\Jssdk($this->config['appid'],$this->config['secret']); $access_token= $jssdk->getAccessToken();//獲取token $url='https://api.weixin.qq.com/wxa/generatescheme?access_token='.$access_token; $params=[ 'jump_wxa'=>[ 'path'=>'/pages/goods/view/view', 'query'=>'goods_id=50' ] ]; $res = $this->post($url, json_encode($params));//請求微信服務端 echo $res;
返回的信息如下:
直接在微信app內使用weixin://打開的效果如下:
也可以在外部h5網頁(這樣可以在手機瀏覽器,微博、抖音等第三方app中使用h5鏈接打開),效果如下:
至于有啥用,這個得看你的應用場景,總的來說就是在外部可以打開小程序的任意頁面路徑。比如在抖音中引導粉絲關注公眾號或個人微信賬號,就可以通過跳轉到小程序,然后小程序頁面中嵌入微信二維碼進行長按識別直接添加微信號等。
我們在微信上24小時期待你的聲音
解答本文疑問/技術咨詢/運營咨詢/技術建議/互聯(lián)網交流