Karakteristik dan batasan

API quota limit

• The limit for using the OneLink API to create, edit, or delete OneLink links is 7.5 million per month (UTC timezone), per account.
• All requests that are made after exceeding this quota are not served, and the links are not created; the API call receives error status code 429 with the message "Monthly quota exceeded".
  
• Information regarding how much of the rate quota is used/remains is displayed in the OneLink API dashboard. 

Rate limit

• The API rate limit per account is 500 requests per second (30000 per minute).
• All requests that are made exceeding 500 requests per second (30000 per minute) are not served, and the links are not created; the API call receives error status code 429 with the message "Rate limit exceeded".

Visibilitas tautan

• Tautan yang dibuat melalui API tidak muncul di daftar tautan khusus OneLink di dashboard AppsFlyer.
• Praktik terbaik: Simpan tautan yang dibuat API ke tabel lokal, sehingga Anda dapat mengakses tautan untuk tujuan apa pun di masa mendatang. 

TTL 

• Masa pakai data (Time to Live/TTL) untuk URL pendek OneLink yang dibuat melalui OneLink API adalah 31 hari. Waktu ini diperpanjang 31 hari setiap kali tautan diklik. Mengklik tautan seperti ini setelah TTL kedaluwarsa masih default ke perilaku yang ditentukan dalam konfigurasi dasar OneLink, tetapi atribusi tidak akan berfungsi.
  • It can take up to 48 hours for a OneLink short URL to be deleted after the TTL expires.
• TTL maksimum adalah 31 hari. Nilai TTL apa pun yang lebih besar dari 31 diganti dengan TTL default 31.
• ​Anda dapat mengubah TTL default dengan menambahkan parameter ttl={value} dan menentukan berapa hari, jam, atau menitnya. Sebagai contoh ttl=7d , ttl=12h , atau ttl=10m.
• Anda dapat mengirim permintaan pembaruan untuk menentukan TTL. Setiap permintaan pembaruan mereset TTL (untuk tautan yang ada) ke yang ditentukan pada body permintaan.
  • Ini berarti TTL diganti. Misalnya, jika Anda melakukan panggilan pembaruan dengan TTL 2d untuk tautan yang saat ini memiliki TTL 29d, itu akan berubah menjadi TTL=2d (bukan 31d).
  • Panggilan pembaruan berpotensi memperpanjang masa pakai tautan atribusi. Misalnya, jika Anda melakukan panggilan pembaruan dengan TTL 31d untuk tautan yang saat ini memiliki TTL 20d tetapi 5 hari telah berlalu, TTL akan menjadi 31d sejak waktu pembaruan.
• Jika Anda tidak ingin tautan TTL diperpanjang secara otomatis, tambahkan parameter renew_ttl=false ke tautan Anda. Nilai untuk parameter ini adalah boolean, baik secara true (default) atau false.
• Parameter renew_ttl tidak ditampilkan pada URL yang sebenarnya.

Karakter khusus

Payload

String kueri dari payload tidak boleh melebihi 2.048 karakter.

ID URL

ID URL (atau ID tautan pendek) dapat diedit untuk menyoroti penawaran kampanye Anda. Misalnya: https://myapp.onelink.me/abc123/apples. ID URL tidak boleh lebih dari 50 karakter dan dapat berupa kombinasi huruf dan angka. Defaultnya adalah 8 karakter.

Catatan:

• Anda hanya dapat mengedit ID URL jika ID saat ini belum digunakan.
• Jika ID URL sudah digunakan, pembuatan tautan akan gagal dan menampilkan respons kesalahan (400). Anda dan pengembang Anda perlu memutuskan dan mengonfigurasi apa yang terjadi dalam event semacam itu.
• Panggilan yang gagal masih diperhitungkan dalam kuota API bulanan Anda.