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 Đường liên kết động dài hoặc một đối tượng chứa các tham số của Đường liên kết động và trả về một URL như ví dụ sau:Dynamic LinkDynamic Link

https://example.page.link/WXYZ

Đường liên kết động 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 FirebaseDynamic Links Các Dynamic Links như vậy được dùng để chia sẻ giữa người dùng với nhau. Đối với các trường hợp sử dụng tiếp thị, hãy tiếp tục tạo đường liên kết trực tiếp thông qua trang của bảng điều khiển.Dynamic LinksFirebase

Trước khi bắt đầu

  1. Lấy khoá API. Bạn sẽ cần có khoá API để xác thực các yêu cầu gửi đế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 đượ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. Ghi lại giá trị của trường Khoá API web.
  2. Trong bảng điều khiển Firebase, hãy mở phần 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 lại miền đó. Bạn cần cung cấp miền Dynamic Links khi tạo Dynamic Links theo phương thức lập trình.

Bạn có thể dùng API Đường liên kết động của Firebase để rút ngắn Dynamic Link dài. Để làm như vậy, hãy gửi yêu cầu POST qua HTTP đến điểm cuối shortLinks, chỉ định dài Dynamic Link 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 Dynamic Link ngắn bằng cách chỉ định các tham số của Dynamic Link trực tiếp. Để làm như vậy, hãy gửi yêu cầu POST qua HTTP đến shortLinks điểm cuối, 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 độ dài của một Dynamic Link ngắn

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 ngắn Dynamic Link.

Theo mặc định hoặc nếu bạn đặt tham số thành "UNGUESSABLE", thành phần đường dẫn sẽ là một chuỗi gồm 17 ký tự, 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 dùng chế độ cài đặt này để ngăn URL Dynamic Links của bạn 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ành phần đường dẫn sẽ là một chuỗi có độ dài vừa đủ để trở nên duy nhất, với độ dài tối thiểu là 4 ký tự.

https://example.page.link/WXYZ

Hãy dùng phương thức này nếu thông tin nhạy cảm sẽ không bị lộ khi URL Dynamic Link ngắn bị đoán.

Ví dụ sau đây cho biết 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"
   }
}

Ít nhất, giá trị đường liên kết sâu được cung cấp phải bắt đầu bằng lược đồ http:// hoặc https://. Giá trị 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ới mã lỗi HTTP 400.

Các bước tiếp theo

Sau khi tạo Dynamic Links, bạn cần thiết lập ứng dụng để nhận Dynamic Links và chuyển 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 bị 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á, phản hồi sẽ trả về mã lỗi HTTP 429. Để yêu cầu thêm hạn mức, hãy điền vào biểu mẫu này.