Dapatkan kode QR untuk menghubungkan perangkat

GET 
/api/getQR

Endpoint untuk mengambil QR code yang digunakan dalam proses menghubungkan perangkat ke WhatsApp. QR code dikembalikan dalam bentuk string yang bisa dirender menjadi gambar di sisi aplikasi.

Prasyarat:

• API Key tersedia.
• Layanan sudah diaktifkan via serviceStart dan perangkat dalam status SERVICE_SCAN.

Request

Responses

200

Kode QR berhasil diambil.

400

Perangkat sudah terhubung atau layanan belum dimulai.

Cara Render qrString Menjadi Gambar QR

Nilai qrString dari response adalah string mentah QR code, bukan gambar. Untuk menampilkannya sebagai gambar QR, gunakan library QR code generator:

Bahasa	Library
PHP	chillerlan/php-qrcode atau endroid/qr-code
Python	qrcode
Node.js	qrcode

Contoh render dengan Node.js:

const QRCode = require('qrcode');

QRCode.toDataURL(qrString, (err, url) => {  
    if (err) throw err;  
    // url berisi gambar QR dalam format data:image/png;base64,...  
    console.log(url);  
});

Catatan Penting

• QR code hanya valid selama beberapa detik. Jika kedaluwarsa, panggil endpoint ini kembali untuk mendapatkan QR baru
• Endpoint ini hanya mengembalikan data saat status perangkat adalah SERVICE_SCAN
• Alternatif yang lebih mudah: scan QR langsung dari dashboard Whapi tanpa perlu memanggil endpoint ini

Error Umum dan Solusinya

Kondisi	Penyebab	Solusi
QR tidak tersedia	Perangkat sudah terhubung atau layanan belum diaktifkan	Periksa status via getState. Jika sudah CONNECTED, tidak perlu scan QR
QR kedaluwarsa sebelum di-scan	QR hanya valid beberapa detik	Panggil endpoint kembali untuk mendapatkan QR baru