Bạn có thể tạo Liên kết động ngắn bằng API REST Liên kết động của Firebase. API này chấp nhận Liên kết động dài hoặc đối tượng chứa tham số Liên kết động và trả về một URL 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 khóa API để xác thự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.
- Hãy 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 các đ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 ý đến 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 liên kết ngắn từ liên kết 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 liên kết ngắn từ 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 tài liệu tham khảo 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à 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ằng các số 96 bit được tạo ngẫu nhiên bằng mã hóa base62. Sử dụng cài đặt này để ngăn chặn việc đoán và thu thập thông tin các URL Liên kết động của bạn, điều này có khả năng tiết 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ành phần đường dẫn sẽ là một chuỗi chỉ có độ dài cần thiết và duy nhất, có độ 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 không bị lộ nếu đoán được URL 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 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á thì 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 .