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

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

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) sẽ không xuất hiện trong bảng điều khiển của Firebase. Những Đường liên kết động như vậy là để chia sẻ giữa người dùng với nhau. Đối với các trường hợp sử dụng cho hoạt động tiếp thị, hãy tiếp tục tạo đường liên kết ngay trên trang Đường liên kết động của bảng điều khiển của Firebase.

Trước khi bắt đầu

Lấy khoá API. Bạn sẽ cần có một khoá API để xác thực yêu cầu của mình với API. Cách tìm khoá API:
1. Mở trang Cài đặt của bảng điều khiển của 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. Ghi lại giá trị của trường Web API Key.
Trong bảng điều khiển của Firebase, hãy mở mục Đường liên kết động.
Nếu bạn chưa chấp nhận điều khoản dịch vụ và đặt miền cho Đường liên kết động, hãy thực hiện khi được nhắc.

Nếu bạn đã có miền Đường liên kết động, hãy ghi lại miền đó. Bạn cần cung cấp miền Đường liên kết động khi tạo Đường liên kết động theo phương thức lập trình.

Tạo một đường liên kết động ngắn

Tạo đường liên kết ngắn từ một đường liên kết dài

Bạn có thể sử dụng API Liên kết động của Firebase để rút ngắn một Đường liên kết động dài. Để thực hiện việc này, hãy gửi yêu cầu POST qua HTTP đến điểm cuối shortLinks, trong đó chỉ định Đường liên kết động 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 Đường liên kết động dài.

Tạo đường liên kết ngắn từ các tham số

Bạn cũng có thể tạo một Đường liên kết động ngắn bằng cách chỉ định trực tiếp các tham số của Đường liên kết động. Để thực hiện việc này, hãy gửi yêu cầu POST qua HTTP đến điểm cuối shortLinks, trong đó chỉ định các tham số Đường liên kết động 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ố đầy đủ về đối tượng dynamicLinkInfo, hãy xem tài liệu tham khảo API.

Đặt độ dài của một đường liên kết động 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 liên kết động ngắn.

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ự, 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ác số 96 bit được tạo ngẫu nhiên bằng phương thức mã hoá base62. Sử dụng chế độ cài đặt này để ngăn ngừa khả năng đoán và thu thập dữ liệu các URL liên kết động của bạn, vì việc này có thể để 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 chỉ có độ dài cần thiết là 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ị tiết lộ trong trường hợp dự đoán là một URL đường liên kết động ngắ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"
   }
}

Đảm bảo đường liên kết sâu là hợp lệ

Ít nhất, giá trị đường liên kết sâu mà bạn 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 của mẫu URL được nhập vào 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

Bây giờ, khi đã tạo Liên kết động, bạn cần thiết lập ứng dụng để nhận Đường liên kết động 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 Đường liên kết động trong ứng dụng, hãy xem tài liệu dành cho iOS, Android, C++ và Unity.

Giới hạn ở 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. Để yêu cầu tăng hạn mức, hãy điền vào biểu mẫu này.