喚起微信小程序

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

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

auth.getAccessToken

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

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

請求地址

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

請求參數(shù)

返回值

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

errcode 的合法值

返回數(shù)據(jù)示例

正常返回

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

錯誤時返回

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

access_token 的存儲與更新

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

詳情可參考微信公眾平臺文檔 《獲取access_token》

1.生成鏈接

urllink.generate

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

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

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

調(diào)用方式：

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

HTTPS 調(diào)用

請求地址

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

請求參數(shù)

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

返回值

url_link

生成的小程序 URL Link

返回值說明

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

示例

請求

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

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

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

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

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

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

調(diào)用上限

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

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

2.2 喚起小程序：URL Link

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

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

調(diào)用上限

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

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

注意事項

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

示例代碼

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

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

兼容性

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

相關(guān)鏈接

urlscheme.generate | 微信開放文檔
獲取 URL Link | 微信開放文檔
獲取 URL Scheme | 微信開放文檔

最新評論