Autentikasi - Dokumentasi BGWA

API key per device

Setiap device punya API key sendiri. Key itu menentukan nomor WhatsApp pengirim, kuota, dan paket yang dipakai. Tidak ada login atau token sesi: cukup kirim API key di setiap request.

Header wajib

Authorization: Bearer bgwa_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
Content-Type: application/json

Key berbentuk bgwa_ diikuti 48 karakter heksadesimal. BGWA hanya menyimpan hash dan versi terenkripsi, bukan teks asli.

Mengambil API key

Masuk ke dashboard, buka menu Device.
Klik ikon kunci pada device yang dituju.
Salin API key. Anda bisa membuat ulang (rotasi) atau mencabutnya dari menu yang sama.

Cek status device

Gunakan endpoint ini untuk memastikan API key benar dan device masih terhubung.

GET https://bgwa.web.id/api/v1/device

cURL

curl https://bgwa.web.id/api/v1/device \
  -H "Authorization: Bearer YOUR_API_KEY"

200 OK

{
  "device": "toko-saya",
  "status": "open",
  "wa_number": "6281234567890"
}

Field	Keterangan
`device`	Nama device.
`status`	`open` berarti terhubung dan siap mengirim. Status lain berarti device belum terhubung (mis. perlu scan ulang).
`wa_number`	Nomor WhatsApp yang terhubung ke device.

Batas laju request

Batas API adalah 60 request per menit per API key. Jika terlampaui, server menjawab 429 dengan header Retry-After (detik). Batas ini terpisah dari batas pengiriman WhatsApp yang dijelaskan di Cara pengiriman.

Jika autentikasi gagal

Status	Penyebab	Tindakan
`401`	API key salah, tidak dikirim, atau sudah dicabut.	Periksa header `Authorization` dan ambil key terbaru di dashboard.
`403`	Langganan pemilik device tidak aktif atau akun disuspend.	Perpanjang paket di menu Dompet, atau hubungi admin.
`409`	Device belum terhubung ke WhatsApp.	Scan ulang QR di menu Device.

Daftar lengkap ada di Kode error.