API Keys
Membuat dan mengelola API key untuk mengakses Dilztify API dari server/aplikasi lain.
API key adalah cara autentikasi yang direkomendasikan untuk pemakaian server-to-server: tanpa perlu login ulang, refresh token, atau menyimpan password di aplikasi lain.
Membuat API Key
Buka menu API Keys di dashboard, lalu klik Buat API Key. Isi:
| Field | Wajib | Keterangan |
|---|---|---|
| Nama | ✅ | Label untuk mengenali key ini di dashboard |
| Izin | ✅ | Endpoint API publik yang boleh dipakai key ini, atau Semua (*) |
Jangan expose API key di frontend
API key bisa memakai semua endpoint API publik akun pemiliknya, kecuali kamu membatasinya lewat izin di bawah. Jangan pernah menaruhnya di kode client-side (browser/mobile app), selalu panggil dari backend/server kamu sendiri.
Izin (Scope) API Key
Batasi key ke endpoint yang memang dibutuhkan aplikasi kamu. Jika key bocor, kerusakannya terbatas pada izin tersebut. Pilih Semua endpoint API publik (*) untuk akses penuh.
| Izin | Endpoint |
|---|---|
send.message | POST /v1/wa/send/message |
send.image | POST /v1/wa/send/image |
send.audio | POST /v1/wa/send/audio |
send.file | POST /v1/wa/send/file |
send.sticker | POST /v1/wa/send/sticker |
send.video | POST /v1/wa/send/video |
send.contact | POST /v1/wa/send/contact |
send.link | POST /v1/wa/send/link |
send.location | POST /v1/wa/send/location |
send.poll | POST /v1/wa/send/poll |
send.presence | POST /v1/wa/send/presence dan /v1/wa/send/chat-presence |
devices.read | GET /v1/devices dan GET /v1/devices/{id} |
devices.write | Membuat, mengubah, menghapus, login, logout, reconnect, dan share-link perangkat |
webhook_logs.read | GET /v1/devices/{id}/webhook-logs |
Request ke endpoint di luar izin key ditolak dengan status 403:
{ "success": false, "message": "API key tidak punya izin untuk endpoint ini", "error_code": "FORBIDDEN" }Key lama tetap berfungsi
API key yang dibuat sebelum fitur izin ada tidak punya batasan, jadi tetap bisa memakai semua endpoint. Izin tidak bisa diubah setelah key dibuat; buat key baru dengan izin yang diinginkan, lalu cabut yang lama.
Menggunakan API Key
Kirim sebagai Authorization header dengan skema Bearer saat memanggil endpoint kirim pesan:
curl -X POST https://api.dilztify.my.id/v1/wa/send/message \
-H "Authorization: Bearer $API_KEY" \
-H "X-Device-Id: $DEVICE_ID" \
-H "Content-Type: application/json" \
-d '{ "phone": "6289685028129", "message": "Halo!" }'Lihat Sending Messages untuk daftar lengkap endpoint yang bisa dipanggil dengan API key ini.
Mengganti Nama & Mencabut (Revoke)
Dari menu API Keys, gunakan aksi (â‹®) pada tiap key untuk Rename atau Revoke.
Setelah dicabut, key langsung tidak bisa dipakai lagi untuk request apa pun, tindakan ini tidak bisa dibatalkan. Jika suatu key diduga bocor, segera cabut lalu buat key baru.
Praktik yang Disarankan
- Buat satu API key per aplikasi/server: memudahkan tracking dan revoke terpisah tanpa mengganggu aplikasi lain.
- Beri nama yang deskriptif (mis. "Backend Notifikasi Order", bukan "key1").
- Simpan di environment variable / secret manager, jangan hardcode di repository.
- Rotasi (buat baru, cabut yang lama) secara berkala untuk key yang dipakai jangka panjang.