Membuat Dynamic Links dengan REST API

Anda dapat membuat Dynamic Links pendek dengan Firebase Dynamic Links REST API. API ini menerima Dynamic Link panjang atau objek yang berisi parameter Dynamic Link, serta menampilkan URL seperti contoh berikut:

https://example.page.link/WXYZ

Dynamic Links pendek yang dibuat dengan SDK API dan klien (Android/iOS) tidak ditampilkan di Firebase console. Dynamic Link seperti itu dimaksudkan untuk proses berbagi pengguna-ke-pengguna. Untuk penggunaan dalam pemasaran, terus buat link Anda secara langsung melalui halaman Dynamic Links dari Firebase console.

Sebelum memulai

  1. Dapatkan kunci API Anda. Anda akan memerlukan kunci API untuk mengautentikasi permintaan ke API. Untuk menemukan kunci API:
    1. Buka halaman Setelan di Firebase console. Jika diminta memilih project, pilih project Firebase Anda dari menu.
    2. Catat nilai pada kolom Kunci API Web.
  2. Di Firebase console, buka bagian Dynamic Links.
  3. Jika Anda belum menyetujui persyaratan layanan dan menetapkan domain untuk Dynamic Links Anda, lakukanlah saat diminta.

    Jika Anda sudah memiliki domain Dynamic Links, catatlah. Anda harus menyediakan domain Dynamic Links ketika membuat Dynamic Link secara terprogram.

Anda dapat menggunakan Firebase Dynamic Links API untuk memperpendek Dynamic Links panjang. Untuk melakukannya, buat permintaan POST HTTP ke endpoint shortLinks, dengan menentukan Dynamic Link panjang di parameter longDynamicLink. Contoh:

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

Baca artikel Membuat URL secara manual untuk mempelajari cara membuat Dynamic Links panjang.

Anda juga dapat membuat Dynamic Links pendek dengan menentukan parameter Dynamic Link secara langsung. Untuk melakukannya, buat permintaan POST HTTP ke endpoint shortLinks, dengan menentukan parameter Dynamic Link di parameter dynamicLinkInfo. Contoh:

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

Untuk mengetahui spesifikasi lengkap objek dynamicLinkInfo, baca referensi API.

Menetapkan panjang Dynamic Link pendek

Anda juga dapat menyetel parameter suffix untuk menentukan cara komponen jalur Dynamic Link pendek dihasilkan.

Secara default, atau jika Anda menyetel parameter ke "UNGUESSABLE", komponen jalur akan memiliki panjang string 17 karakter, seperti dalam contoh berikut:

https://example.page.link/UVWXYZuvwxyz12345

String tersebut dibuat dengan enkode base62 yang menghasilkan angka 96-bit secara acak. Gunakan setelan ini untuk mencegah agar URL Dynamic Links Anda tidak ditebak dan di-crawl, karena berpotensi membuka informasi sensitif kepada penerima yang tidak diinginkan.

Jika Anda menyetel parameter ke "SHORT", string komponen jalur hanya akan memiliki panjang yang diperlukan agar terlihat unik dengan panjang minimum 4 karakter.

https://example.page.link/WXYZ

Gunakan metode ini jika informasi sensitif tidak ingin dibuka ketika URL Dynamic Link sudah ditebak.

Contoh berikut menunjukkan cara menyetel parameter 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"
   }
}

Setidaknya, nilai deep link yang diberikan harus dimulai dengan skema http:// atau https://. Nilai tersebut juga harus cocok dengan daftar putih pola URL yang dimasukkan di konsol. Selain itu, API pembuatan akan gagal dengan kode error HTTP 400.

Langkah berikutnya

Setelah membuat Dynamic Links, Anda perlu menyiapkan aplikasi untuk menerima Dynamic Links dan mengirim pengguna ke tempat yang tepat dalam aplikasi Anda setelah mereka membukanya.

Untuk menerima Dynamic Links di aplikasi Anda, baca dokumentasi untuk iOS, Android, C++, dan Unity.

Permintaan dibatasi hingga 5 permintaan/alamat IP/detik, dan 200.000 permintaan/hari. Jika terlampaui, respons akan menampilkan kode error HTTP 429. Untuk meminta kuota lebih banyak, isi formulir ini.