Bạn có thể tạo Liên kết động ngắn bằng API REST của Liên kết động 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 giống như ví dụ sau:
https://example.page.link/WXYZ
Liên kết động ngắn được tạo bằng API và SDK ứng dụng khách (Android/Apple) không hiển thị trong bảng điều khiển Firebase. Các Liên kết Động như vậy nhằm mục đích chia sẻ giữa người dùng với người dùng. Đối với các trường hợp sử dụng tiếp thị, hãy tiếp tục tạo liên kết của bạn trực tiếp thông qua trang Liên kết động của bảng điều khiển Firebase.
Trước khi bắt đầu
- Nhận khóa API của bạn. Bạn sẽ cần một khóa API để xác thực các yêu cầu của mình với API. Để tìm khóa API của bạn:
- 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 từ menu.
- Lưu ý giá trị của trường Khóa API Web .
- Trong bảng điều khiển Firebase, hãy mở phần 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 Liên kết động của mình, hãy làm như vậy khi được nhắc.
Nếu bạn đã có miền Liên kết động, hãy lưu ý về nó. Bạn cần cung cấp miền Liên kết động khi tạo Liên kết động theo chương trình.
Tạo một liên kết động ngắn
Tạo link ngắn từ link dài
Bạn có thể sử dụng API Liên kết động Firebase để rút ngắn Liên kết động dài. Để làm như vậy, hãy tạo một yêu cầu HTTP POST tới điểm cuối shortLinks , chỉ định 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"
}
Xem Tạo URL theo cách thủ công để tìm hiểu cách tạo Liên kết động dài.
Tạo một liên kết ngắn từ các tham số
Bạn cũng có thể tạo một Liên kết động ngắn bằng cách chỉ định trực tiếp các tham số Liên kết động. Để làm như vậy, hãy tạo một yêu cầu HTTP POST tới điểm cuối shortLinks , chỉ định các tham số 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ố kỹ thuật đầy đủ của đối tượng dynamicLinkInfo , hãy xem tham chiếu API .
Đặt độ dài của Liên kết động ngắn
Bạn cũng có thể đặt tham số suffix tố để chỉ định cách tạo thành phần đường dẫn của 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 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ởi các số 96 bit được tạo ngẫu nhiên mã hóa base62. Sử dụng cài đặt này để ngăn các URL Liên kết động của bạn bị đoán và thu thập thông tin, điều này có khả năng làm lộ thông tin nhạy cảm cho những người nhận ngoài ý 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 đến mức 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
Sử dụng phương pháp này nếu thông tin nhạy cảm sẽ không bị lộ nếu một URL Liên kết động ngắn được đoá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 liên kết sâu hợp lệ
Tối thiểu, giá trị liên kết sâu được cung cấp phải bắt đầu bằng lược đồ http:// hoặc https://. Nó cũng phải khớp với bất kỳ danh sách trắng mẫu URL nào đượ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.
Bước tiếp theo
Bây giờ bạn đã tạo Liên kết động, bạn cần thiết lập ứng dụng của mình để nhận Liên kết động và đưa người dùng đến đúng vị trí trong ứng dụng của bạn sau khi người dùng mở chúng.
Để nhận Liên kết động trong ứng dụng của bạn, hãy xem tài liệu dành cho iOS , Android , C++ và Unity .
Yêu cầu được 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á, phản hồi sẽ trả về mã lỗi HTTP 429. Để yêu cầu thêm hạn ngạch, hãy điền vào biểu mẫu này .