Tạo đường liên kết động bằng API REST

Bạn có thể tạo Dynamic Links ngắn bằng API REST của Đường liên kết động của Firebase. API này chấp nhận Dynamic Link dài hoặc một đối tượng chứa các tham số Dynamic Link, đồng thời trả về một URL như ví dụ sau:

https://example.page.link/WXYZ

Dynamic Links ngắn được tạo bằng API và SDK ứng dụng (Android/Apple) không xuất hiện trong bảng điều khiển Firebase. Dynamic Links như vậy là để người dùng chia sẻ với nhau. Đối với các trường hợp sử dụng cho mục đích tiếp thị, hãy tiếp tục tạo đường liên kết trực tiếp thông qua trang Dynamic Links của bảng điều khiển Firebase.

Trước khi bắt đầu

  1. Lấy khoá API. Bạn sẽ cần một khoá API để xác thực các yêu cầu của mình đến API. Cách tìm khoá API:
    1. Mở trang Cài đặt của bảng điều khiển Firebase. Nếu bạn được nhắc chọn một dự án, hãy chọn dự án Firebase của bạn trong trình đơn.
    2. Hãy ghi lại giá trị của trường Web API Key (Khoá API web).
  2. Trong bảng điều khiển Firebase, hãy mở mục Dynamic Links.

  3. Nếu bạn chưa chấp nhận điều khoản dịch vụ và đặt miền cho Dynamic Links, hãy làm như vậy khi được nhắc.

    Nếu bạn đã có miền Dynamic Links, hãy ghi nhớ miền đó. Bạn cần cung cấp một miền Dynamic Links khi tạo Dynamic Links theo phương thức lập trình.

Bạn có thể sử dụng API Đường liên kết động của Firebase để rút ngắn Dynamic Link dài. Để làm việc này, hãy gửi một yêu cầu POST qua HTTP đến điểm cuối shortLinks, chỉ định Dynamic Link dài trong tham số longDynamicLink. Ví dụ:

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

Hãy xem phần Tạo URL theo cách thủ công để tìm hiểu cách tạo Dynamic Links dài.

Bạn cũng có thể tạo một Dynamic Link ngắn bằng cách chỉ định trực tiếp các tham số Dynamic Link. Để làm việc này, hãy gửi một yêu cầu POST qua HTTP đến điểm cuối shortLinks, chỉ định các tham số Dynamic Link trong tham số dynamicLinkInfo. Ví dụ:

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

Để biết thông số kỹ thuật đầy đủ của đối tượng dynamicLinkInfo, hãy xem Tài liệu tham khảo API.

Đặt thời lượng của video ngắn Dynamic Link

Bạn cũng có thể đặt tham số suffix để chỉ định cách tạo thành phần đường dẫn của Dynamic Link ngắn.

Theo mặc định hoặc nếu bạn đặt tham số thành "UNGUESSABLE", thì thành phần đường dẫn sẽ là một chuỗi gồm 17 ký tự, chẳng hạn như trong ví dụ sau:

https://example.page.link/UVWXYZuvwxyz12345

Các chuỗi như vậy được tạo bằng cách mã hoá base62 các số 96 bit được tạo ngẫu nhiên. Hãy sử dụng chế độ cài đặt này để ngăn URL Dynamic Links bị đoán và thu thập dữ liệu, điều này có thể làm lộ thông tin nhạy cảm cho những người nhận không mong muốn.

Nếu bạn đặt tham số thành "SHORT", thì thành phần đường dẫn sẽ là một chuỗi chỉ dài bằng mức cần thiết để đảm bảo tính duy nhất, với độ dài tối thiểu là 4 ký tự.

https://example.page.link/WXYZ

Hãy sử dụng phương thức này nếu thông tin nhạy cảm không bị lộ khi người khác đoán được Dynamic Link URL rút gọn.

Ví dụ sau đây cho thấy cách bạn có thể đặt tham số 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"
   }
}

Giá trị đường liên kết sâu được cung cấp phải bắt đầu bằng giao thức http:// hoặc https://. URL này cũng phải khớp với mọi danh sách cho phép mẫu URL được nhập trong bảng điều khiển. Nếu không, API tạo sẽ không thành công và trả về mã lỗi HTTP 400.

Các bước tiếp theo

Giờ đây, khi đã tạo Dynamic Links, bạn cần thiết lập ứng dụng để nhận Dynamic Links và đưa người dùng đến đúng vị trí trong ứng dụng sau khi người dùng mở các đường liên kết đó.

Để nhận Dynamic Links trong ứng dụng, hãy xem tài liệu về iOS, Android, C++ và Unity.

Yêu cầu được giới hạn ở mức 5 yêu cầu/địa chỉ IP/giây và 200.000 yêu cầu/ngày. Nếu vượt quá, thì phản hồi sẽ trả về mã lỗi HTTP 429.