喚起微信小程序

目的：為了跳轉(zhuǎn)到微信環(huán)境下，可以進(jìn)行長(zhǎng)按掃碼

0. 接口調(diào)用憑證

auth.getAccessToken

本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說(shuō)明參見(jiàn)服務(wù)端API。

獲取小程序全局唯一后臺(tái)接口調(diào)用憑據(jù)（access_token）。調(diào)用絕大多數(shù)后臺(tái)接口時(shí)都需使用 access_token，開(kāi)發(fā)者需要進(jìn)行妥善保存。 如使用云開(kāi)發(fā)，可通過(guò)云調(diào)用免維護(hù) access_token 調(diào)用。如使用云托管，也可以通過(guò)微信令牌/開(kāi)放接口服務(wù)免維護(hù) access_token 調(diào)用。

請(qǐng)求地址

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

請(qǐng)求參數(shù)

返回值

Object 返回的 JSON 數(shù)據(jù)包

errcode 的合法值

返回?cái)?shù)據(jù)示例

正常返回

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

錯(cuò)誤時(shí)返回

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

access_token 的存儲(chǔ)與更新

• access_token 的存儲(chǔ)至少要保留 512 個(gè)字符空間；
• access_token 的有效期目前為 2 個(gè)小時(shí)，需定時(shí)刷新，重復(fù)獲取將導(dǎo)致上次獲取的 access_token 失效；
• 建議開(kāi)發(fā)者使用中控服務(wù)器統(tǒng)一獲取和刷新 access_token，其他業(yè)務(wù)邏輯服務(wù)器所使用的 access_token 均來(lái)自于該中控服務(wù)器，不應(yīng)該各自去刷新，否則容易造成沖突，導(dǎo)致 access_token 覆蓋而影響業(yè)務(wù)；
• access_token 的有效期通過(guò)返回的 expires_in 來(lái)傳達(dá)，目前是7200秒之內(nèi)的值，中控服務(wù)器需要根據(jù)這個(gè)有效時(shí)間提前去刷新。在刷新過(guò)程中，中控服務(wù)器可對(duì)外繼續(xù)輸出的老 access_token，此時(shí)公眾平臺(tái)后臺(tái)會(huì)保證在5分鐘內(nèi)，新老 access_token 都可用，這保證了第三方業(yè)務(wù)的平滑過(guò)渡；
• access_token 的有效時(shí)間可能會(huì)在未來(lái)有調(diào)整，所以中控服務(wù)器不僅需要內(nèi)部定時(shí)主動(dòng)刷新，還需要提供被動(dòng)刷新 access_token 的接口，這樣便于業(yè)務(wù)服務(wù)器在API調(diào)用獲知 access_token 已超時(shí)的情況下，可以觸發(fā) access_token 的刷新流程。

詳情可參考微信公眾平臺(tái)文檔 《獲取access_token》

1.生成鏈接

urllink.generate

本接口應(yīng)在服務(wù)器端調(diào)用，詳細(xì)說(shuō)明參見(jiàn)服務(wù)端API。

本接口支持云調(diào)用。需開(kāi)發(fā)者工具版本 >= 1.02.1904090（最新穩(wěn)定版下載），wx-server-sdk >= 0.4.0

獲取小程序 URL Link，適用于短信、郵件、網(wǎng)頁(yè)、微信內(nèi)等拉起小程序的業(yè)務(wù)場(chǎng)景。通過(guò)該接口，可以選擇生成到期失效和永久有效的小程序鏈接，有數(shù)量限制，目前僅針對(duì)國(guó)內(nèi)非個(gè)人主體的小程序開(kāi)放，詳見(jiàn)獲取 URL Link

調(diào)用方式：

• HTTPS 調(diào)用
• 云調(diào)用

HTTPS 調(diào)用

請(qǐng)求地址

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

請(qǐng)求參數(shù)

cloud_base 的結(jié)構(gòu)

返回值

url_link

生成的小程序 URL Link

返回值說(shuō)明

如果調(diào)用成功，會(huì)直接返回生成的小程序 URL Link。如果請(qǐng)求失敗，會(huì)返回 JSON 格式的數(shù)據(jù)。

示例

請(qǐng)求

{
    "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

通過(guò)服務(wù)端接口或在小程序管理后臺(tái)「工具」-「生成 URL Scheme」入口可以獲取打開(kāi)小程序任意頁(yè)面的 URL Scheme。適用于從短信、郵件、微信外網(wǎng)頁(yè)等場(chǎng)景打開(kāi)小程序。 通過(guò) URL Scheme 打開(kāi)小程序的場(chǎng)景值為 1065。
生成的 URL Scheme 如下所示：

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

iOS系統(tǒng)支持識(shí)別 URL Scheme，可在短信等應(yīng)用場(chǎng)景中直接通過(guò)Scheme跳轉(zhuǎn)小程序。
Android系統(tǒng)不支持直接識(shí)別 URL Scheme，用戶無(wú)法通過(guò) Scheme 正常打開(kāi)小程序，開(kāi)發(fā)者需要使用 H5 頁(yè)面中轉(zhuǎn)，再跳轉(zhuǎn)到 Scheme 實(shí)現(xiàn)打開(kāi)小程序，跳轉(zhuǎn)代碼示例如下：

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

該跳轉(zhuǎn)方法可以在用戶打開(kāi) H5 時(shí)立即調(diào)用，也可以在用戶觸發(fā)事件后調(diào)用。

調(diào)用上限

Scheme 將根據(jù)是否為到期有效與失效時(shí)間參數(shù)，分為短期有效Scheme與長(zhǎng)期有效Scheme：

1. 單個(gè)小程序每日生成 Scheme 上限為50萬(wàn)個(gè)（包含短期有效 Scheme 與長(zhǎng)期有效 Scheme）
2. 有效時(shí)間超過(guò)180天的 Scheme 或永久有效的 Scheme 為長(zhǎng)期有效Scheme，單個(gè)小程序總共可生成長(zhǎng)期有效 Scheme 上限為10萬(wàn)個(gè)，請(qǐng)謹(jǐn)慎調(diào)用
3. 有效時(shí)間不超過(guò)180天的 Scheme 為短期有效Scheme，單個(gè)小程序生成短期有效 Scheme 不設(shè)上限

2.2 喚起小程序：URL Link

通過(guò)服務(wù)端接口可以獲取打開(kāi)小程序任意頁(yè)面的 URL Link。適用于從短信、郵件、網(wǎng)頁(yè)、微信內(nèi)等場(chǎng)景打開(kāi)小程序。 通過(guò) URL Link 打開(kāi)小程序的場(chǎng)景值為 1194。
生成的 URL Link 如下所示：

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

調(diào)用上限

Link 將根據(jù)是否為到期有效與失效時(shí)間參數(shù)，分為短期有效Link 與 長(zhǎng)期有效Link：

1. 單個(gè)小程序每日生成 Link 上限為50萬(wàn)個(gè)（包含短期有效 Link 與長(zhǎng)期有效 Link ）
2. 有效時(shí)間超過(guò)180天的 Link 或永久有效的 Link 為長(zhǎng)期有效Link，單個(gè)小程序總共可生成長(zhǎng)期有效 Link 上限為10萬(wàn)個(gè)，請(qǐng)謹(jǐn)慎調(diào)用
3. 有效時(shí)間不超過(guò)180天的 Link 為短期有效Link，單個(gè)小程序生成短期有效 Link 不設(shè)上限

注意事項(xiàng)

1. 只能生成已發(fā)布的小程序的 URL Link。
2. 在微信內(nèi)或者安卓手機(jī)打開(kāi) URL Link 時(shí)，默認(rèn)會(huì)先跳轉(zhuǎn)官方 H5 中間頁(yè)，如果需要定制 H5 內(nèi)容，可以使用云開(kāi)發(fā)靜態(tài)網(wǎng)站。

示例代碼

默認(rèn)官方 H5 示例地址：https://wxaurl.cn/pFawq35qbfd

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

兼容性

記錄在IOS、安卓環(huán)境下各應(yīng)用調(diào)起小程序的情況

相關(guān)鏈接

urlscheme.generate | 微信開(kāi)放文檔
獲取 URL Link | 微信開(kāi)放文檔
獲取 URL Scheme | 微信開(kāi)放文檔

最新評(píng)論