🚫 Anda tidak terhubung ke internet
Dokumentasi Web

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:

FieldWajibKeterangan
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.

IzinEndpoint
send.messagePOST /v1/wa/send/message
send.imagePOST /v1/wa/send/image
send.audioPOST /v1/wa/send/audio
send.filePOST /v1/wa/send/file
send.stickerPOST /v1/wa/send/sticker
send.videoPOST /v1/wa/send/video
send.contactPOST /v1/wa/send/contact
send.linkPOST /v1/wa/send/link
send.locationPOST /v1/wa/send/location
send.pollPOST /v1/wa/send/poll
send.presencePOST /v1/wa/send/presence dan /v1/wa/send/chat-presence
devices.readGET /v1/devices dan GET /v1/devices/{id}
devices.writeMembuat, mengubah, menghapus, login, logout, reconnect, dan share-link perangkat
webhook_logs.readGET /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.

On this page