Tim Kencang.in
API Kencang.in memungkinkan aplikasi Anda membuat, membaca, mengubah, dan menghapus link pendek, QR code, serta bio page tanpa membuka dasbor. Artikel ini adalah titik awal: cara mendapatkan kunci, format permintaan, dan contoh pertama yang bisa dijalankan dalam lima menit. Dokumentasi lengkap tiap endpoint tersedia di halaman developer.
1. Mendapatkan kunci API
Masuk ke dasbor, buka menu Developer (atau Pengaturan > API). Setiap akun memiliki satu kunci utama, dan Anda bisa membuat kunci tambahan dengan nama berbeda untuk tiap aplikasi, sehingga kunci yang bocor dapat dicabut tanpa mengganggu integrasi lain. Akses API tersedia pada paket Pro dan Bisnis; lihat batasnya di halaman harga.
2. Autentikasi
Semua permintaan harus menyertakan header Authorization: Bearer KUNCI_API_ANDA. Skema Bearer mengikuti RFC 6750. Permintaan tanpa kunci atau dengan kunci yang dicabut mendapat respons HTTP 401. Selalu kirim permintaan melalui HTTPS; kunci yang dikirim lewat HTTP biasa dianggap bocor.
3. Format permintaan dan respons
API menerima dan mengembalikan JSON. Sertakan header Content-Type: application/json pada permintaan POST dan PUT. Setiap respons memiliki kunci error: nilai 0 berarti sukses, selain itu akan disertai message yang menjelaskan masalahnya. Periksa kunci ini sebelum membaca data lain. Format JSON mengikuti spesifikasi di json.org.
4. Permintaan pertama: membuat link pendek
Parameter yang umum dipakai pada endpoint pembuatan link:
url(wajib): URL tujuan, harus diawali http:// atau https://.custom: alias kustom. Jika kosong, alias acak dibuat.domain: domain bermerek yang sudah terverifikasi di akun Anda.password: proteksi kata sandi.expiry: tanggal kedaluwarsa dalam format YYYY-MM-DD.type: jenis pengalihan, misalnyadirectatausplashuntuk landing page kustom.metatitle,metadescription: judul dan deskripsi pratinjau.geotarget,devicetarget,languagetarget: aturan penargetan dalam bentuk array.
Respons berisi id link dan shorturl yang siap dibagikan. Simpan id jika aplikasi Anda perlu mengubah atau menghapus link tersebut nanti.
5. Membaca dan mengelola link
GET /api/urls: daftar link dengan paginasi (parameterpage,limit,order).GET /api/url/{id}: detail satu link beserta statistik ringkas.PUT /api/url/{id}/update: mengubah tujuan, alias, atau pengaturan lain.DELETE /api/url/{id}/delete: menghapus link.
Endpoint serupa tersedia untuk QR code, bio page, kampanye, domain, dan pixel. Contoh kode dalam beberapa bahasa pemrograman kami tulis terpisah di artikel membuat link pendek lewat API dengan PHP, Python, dan JavaScript.
6. Rate limit
Setiap paket memiliki batas permintaan per menit. Header respons X-RateLimit-Limit dan X-RateLimit-Remaining memberi tahu sisa kuota, dan permintaan yang melebihi batas mendapat HTTP 429. Strategi menanganinya dibahas di artikel rate limit dan penanganan error.
7. Praktik keamanan kunci API
- Simpan kunci di variabel lingkungan atau secret manager, bukan di repositori kode.
- Jangan pernah memakai kunci di JavaScript sisi browser atau aplikasi mobile yang didistribusikan; buat backend perantara.
- Buat kunci terpisah per aplikasi dan cabut kunci yang tidak terpakai.
- Rekomendasi umum pengelolaan rahasia dapat dibaca di OWASP Secrets Management Cheat Sheet.
Langkah berikutnya
Setelah permintaan pertama berhasil, Anda bisa mengotomatiskan pembuatan link dari spreadsheet lewat Zapier dan Google Sheets, atau menerima notifikasi klik secara real-time lewat webhook dan Slack.
Pertanyaan umum
Apakah API tersedia di paket Gratis?
Akses API tersedia pada paket Pro dan Bisnis. Paket Pro mendapat 60 permintaan per menit dan paket Bisnis 300 per menit. Masa uji coba 7 hari pada paket berbayar sudah mencakup akses API penuh untuk menguji integrasi.
Bagaimana jika kunci API saya bocor?
Segera cabut kunci tersebut dari menu Developer dan buat kunci baru. Karena setiap kunci berdiri sendiri, integrasi lain yang memakai kunci berbeda tidak terganggu. Periksa juga log permintaan untuk melihat apakah ada aktivitas mencurigakan.
Apakah API mendukung pembuatan QR code dan bio page?
Ya. Selain link, tersedia endpoint untuk QR code, bio page, kampanye, domain, pixel, dan statistik. Semua endpoint memakai autentikasi Bearer yang sama dan mengembalikan JSON dengan struktur error dan message yang konsisten.
Bisakah API dipanggil dari aplikasi mobile atau JavaScript browser?
Sebaiknya tidak, karena kunci API akan terlihat oleh pengguna. Buat endpoint di backend Anda sendiri yang menyimpan kunci dengan aman dan meneruskan permintaan ke API Kencang.in.
