Mendapatkan API Key

Setiap perangkat (bot) bisa punya beberapa API key, masing-masing dengan izinnya sendiri. Key inilah yang mengautentikasi permintaan API Anda.

Langkah

1. Masuk ke QwikChat. 2. Buka halaman Perangkat. 3. Pilih perangkat, buka bagian API, lalu tekan Buat kunci.

Key hanya ditampilkan satu kali, tepat setelah dibuat. Salin saat itu juga. Kami menyimpan sidik jarinya saja, bukan kuncinya — jadi kalau hilang, tidak ada cara menampilkannya lagi; buat key baru dan cabut yang lama.

Izin

Setiap key membawa izin sendiri: Baca (status koneksi, QR, grup, kontak), Kirim (kirim pesan, notifikasi), dan Kelola (sinkronisasi kontak/grup, putuskan sambungan). Beri key hanya izin yang benar-benar dipakai — skrip laporan yang cuma membaca tidak perlu bisa mengirim pesan atas nama nomor Anda. Permintaan di luar izin key dijawab 403.

Menggunakan key

Sertakan key mentah pada header Authorization di setiap permintaan — tanpa awalan "Bearer".

curl https://qwikchat.app/api/v1/client/connection-status \
  -H "Authorization: YOUR_API_KEY"

Perangkat di workspace paket Gratis tetap bisa membuat API key, tetapi permintaannya dijawab 403. Kalau curl di atas mengembalikan 403 padahal key-nya sudah benar, periksa dua hal: paket WORKSPACE-nya (di halaman Tagihan), dan izin key-nya — pesan pada field error menyebut yang mana.

Rahasiakan API key. Jangan pernah menaruhnya di kode yang berjalan di browser atau aplikasi pengguna akhir — gunakan hanya di sisi server Anda.

Mengganti key tanpa memutus integrasi

Buat key baru, pasang di integrasi Anda, baru cabut yang lama. Membuat key baru tidak mematikan key lain, jadi pergantian bisa dilakukan tanpa jeda. Kalau sebuah key bocor, cabut saja langsung — key lain tidak terpengaruh.

Key juga bisa diberi masa berlaku saat dibuat, dan setiap key mencatat kapan terakhir dipakai — itu yang membuat key lama yang sudah tidak dikenali aman untuk dicabut.

← Ringkasan API Menyambungkan Perangkat →