喚起微信小程序

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

0. 接口調用憑證

auth.getAccessToken

本接口應在服務器端調用，詳細說明參見服務端API。

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

請求地址

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

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

1.生成鏈接

urllink.generate

本接口應在服務器端調用，詳細說明參見服務端API。

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

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

調用方式：

• HTTPS 調用
• 云調用

HTTPS 調用

請求地址

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

請求參數(shù)

cloud_base 的結構

返回值

url_link

生成的小程序 URL Link

返回值說明

如果調用成功，會直接返回生成的小程序 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

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

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

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

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

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

調用上限

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

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

2.2 喚起小程序：URL Link

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

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

調用上限

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

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

注意事項

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

示例代碼

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

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

兼容性

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

相關鏈接

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

最新評論