Join us for Firebase Summit on November 10, 2021. Tune in to learn how Firebase can help you accelerate app development, release with confidence, and scale with ease. Register

使用 REST API 創建動態鏈接

您可以使用 Firebase 動態鏈接 REST API 創建簡短的動態鏈接。此 API 接受長動態鏈接或包含動態鏈接參數的對象,並返回類似以下示例的 URL:

https://example.page.link/WXYZ

使用 API 和客戶端 (Android/iOS) SDK 創建的短動態鏈接不會顯示在 Firebase 控制台中。此類動態鏈接旨在用於用戶對用戶的共享。對於銷售使用情況,繼續直接通過創建鏈接的動態鏈接頁面的火力地堡控制台。

在你開始之前

  1. 獲取您的 API 密鑰。您將需要一個 API 密鑰來驗證您對 API 的請求。要查找您的 API 密鑰:
    1. 打開設置頁面的火力地堡控制台。如果系統提示您選擇一個項目,請從菜單中選擇您的 Firebase 項目。
    2. 記下的Web API密鑰字段的值。
  2. 在火力地堡控制台,打開動態鏈接部分。
  3. 如果您尚未接受服務條款並為您的動態鏈接設置域,請在出現提示時進行。

    如果您已經有一個動態鏈接域,請記下它。以編程方式創建動態鏈接時,您需要提供動態鏈接域。

您可以使用 Firebase 動態鏈接 API 來縮短較長的動態鏈接。要做到這一點,使一個HTTP POST請求到shortLinks端點,在指定的長期動態鏈接longDynamicLink參數。例如:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibi=com.example.ios"
}

請參閱手動構建一個URL來學習如何與客戶建立長久的動態鏈接。

您還可以通過直接指定動態鏈接參數來創建簡短的動態鏈接。要做到這一點,使一個HTTP POST請求到shortLinks端點,在指定的動態鏈接參數dynamicLinkInfo參數。例如:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
  "dynamicLinkInfo": {
    "domainUriPrefix": "https://example.page.link",
    "link": "https://www.example.com/",
    "androidInfo": {
      "androidPackageName": "com.example.android"
    },
    "iosInfo": {
      "iosBundleId": "com.example.ios"
    }
  }
}

對於一個完整的規範dynamicLinkInfo對象,請參閱API參考

設置短動態鏈接的長度

您還可以設置suffix參數指定如何產生短期動態鏈接的路徑組件。

默認情況下,或者如果你的參數設置為"UNGUESSABLE" ,路徑組件將是一個17個字符的字符串,如下面的例子:

https://example.page.link/UVWXYZuvwxyz12345

這些字符串是通過 base62 編碼隨機生成的 96 位數字創建的。使用此設置可防止您的動態鏈接 URL 被猜測和抓取,這可能會將敏感信息暴露給非預期的收件人。

如果將該參數設置為"SHORT"路徑組件將是一個字符串,它是唯一的,只要需要的是獨特的,有4個字符的最小長度。

https://example.page.link/WXYZ

如果在猜測到一個簡短的動態鏈接 URL 時不會暴露敏感信息,請使用此方法。

下面的例子展示了如何設置suffix參數:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=http://www.example.com/&apn=com.example.android&ibi=com.example.ios",
   "suffix": {
     "option": "UNGUESSABLE"
   }
}

提供的深層鏈接值至少必須以 http:// 或 https:// 方案開頭。它還必須匹配在控制台中輸入的任何 URL 模式白名單。否則,創建 API 將失敗並顯示 HTTP 錯誤代碼 400。

下一步

現在您已經創建了動態鏈接,您需要設置您的應用程序以接收動態鏈接並在用戶打開它們後將用戶發送到您應用程序中的正確位置。

要接收動態鏈接在你的應用程序,請參閱該文檔的iOS安卓C ++ ,和團結

請求限制為 5 個請求/IP 地址/秒,以及 200,000 個請求/天。如果突破,則響應將返回HTTP錯誤代碼429,請求更多配額,請填寫此表格