Ambil Session

GET /session

Ambil data sesi: QR code, status koneksi, nama, dan foto profil akun WhatsApp yang nyambung. Habis Buat Session atau Reset Session, endpoint ini yang kamu panggil berulang-ulang sampai QR-nya di-scan.

Endpoint ini juga aman dipanggil waktu sesinya lagi putus, jadi cocok banget buat ngecek koneksi secara berkala.

Detail Endpoint

• Base URL: https://api-zawa.azickri.com
• Header: id dan session-id

Header

Header	Tipe	Wajib	Keterangan
id	string	Ya	id dari Buat Session.
session-id	string	Ya	sessionId dari Buat Session.

Contoh Request

cURL

curl "https://api-zawa.azickri.com/session" \
  -H "id: YOUR_ID" \
  -H "session-id: YOUR_SESSION_ID"

Axios

import axios from 'axios';

const response = await axios.get('https://api-zawa.azickri.com/session', {
  headers: {
    'id': 'YOUR_ID',
    'session-id': 'YOUR_SESSION_ID',
  },
});

console.log(response.data);

Fetch

const response = await fetch('https://api-zawa.azickri.com/session', {
  headers: {
    'id': 'YOUR_ID',
    'session-id': 'YOUR_SESSION_ID',
  },
});

const data = await response.json();
console.log(data);

Response

200 · Udah nyambung

{
  "id": "68b3f0a2c1d4e5f6a7b8c9d0",
  "generatedId": "6281234567890:[email protected]",
  "name": "Zawa Bot",
  "sessionId": "0b2f7059-8a90-4f6d-8684-b0e1ce6f0310",
  "isConnected": true,
  "qrcode": "",
  "picture": "https://pps.whatsapp.net/v/t61.24694-24/..."
}

200 · Nunggu di-scan

{
  "id": "68b3f0a2c1d4e5f6a7b8c9d0",
  "generatedId": "",
  "name": "",
  "sessionId": "0b2f7059-8a90-4f6d-8684-b0e1ce6f0310",
  "isConnected": false,
  "qrcode": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAAB...",
  "picture": ""
}

400

{
  "statusCode": 400,
  "message": "invalid header"
}

404

{
  "statusCode": 404,
  "message": "session not found"
}

Kolom	Tipe	Keterangan
id	string	ID utama sesi.
generatedId	string	ID WhatsApp (JID) perangkat yang nyambung, formatnya nomor:[email protected]. Kosong kalau belum pernah nyambung.
name	string	Nama akun WhatsApp yang nyambung.
sessionId	string	Pengenal unik sesi.
isConnected	boolean	true kalau sesi lagi nyambung ke WhatsApp.
qrcode	string	Gambar QR dalam bentuk PNG base64, tanpa awalan data:. Kosong kalau udah nyambung atau QR-nya belum siap.
picture	string	URL foto profil akun WhatsApp. Bisa kosong.

Nampilin QR Code

qrcode itu PNG base64 mentah. Tambahin awalan data:image/png;base64, biar bisa langsung dipakai di tag <img>:

const { qrcode, isConnected } = await response.json();

if (!isConnected && qrcode) {
  document.querySelector('#qr').src = `data:image/png;base64,${qrcode}`;
}

Tips polling

• Panggil endpoint ini tiap 2–3 detik selama nunggu di-scan.
• QR-nya bisa berganti beberapa kali, jadi selalu tampilin yang paling baru.
• Berhenti polling begitu isConnected jadi true.
• Kalau tiba-tiba dapet 404, QR-nya udah kedaluwarsa dan sesinya dihapus, jadi bikin sesi baru.