Ambil Session

GET /session

Ambil data sesi: QR code, status koneksi, profil akun Telegram yang login, dan pengaturan webhook. 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-zate.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-zate.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-zate.azickri.com/session', {
  headers: {
    'id': 'YOUR_ID',
    'session-id': 'YOUR_SESSION_ID',
  },
});

console.log(response.data);

Fetch

const response = await fetch('https://api-zate.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": "123456789",
  "name": "Cak Zate",
  "username": "cakzate",
  "phone": "6281234567890",
  "sessionId": "0b2f7059-8a90-4f6d-8684-b0e1ce6f0310",
  "isConnected": true,
  "qrcode": "",
  "isPasswordRequired": false,
  "passwordHint": "",
  "picture": "data:image/jpeg;base64,/9j/4AAQSkZJRgABAQ...",
  "webhook": {
    "url": "https://example.com/webhook/zate",
    "token": "rahasia-banget-123"
  }
}

200 · Nunggu di-scan

{
  "id": "68b3f0a2c1d4e5f6a7b8c9d0",
  "generatedId": "",
  "name": "",
  "username": "",
  "phone": "",
  "sessionId": "0b2f7059-8a90-4f6d-8684-b0e1ce6f0310",
  "isConnected": false,
  "qrcode": "iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAYAAAB...",
  "isPasswordRequired": false,
  "passwordHint": "",
  "picture": "",
  "webhook": { "url": "", "token": "" }
}

200 · Nunggu password

{
  "id": "68b3f0a2c1d4e5f6a7b8c9d0",
  "generatedId": "",
  "name": "",
  "username": "",
  "phone": "",
  "sessionId": "0b2f7059-8a90-4f6d-8684-b0e1ce6f0310",
  "isConnected": false,
  "qrcode": "",
  "isPasswordRequired": true,
  "passwordHint": "nama kucing",
  "picture": "",
  "webhook": { "url": "", "token": "" }
}

400

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

404

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

Kolom	Tipe	Keterangan
id	string	ID utama sesi.
generatedId	string	ID user Telegram akun yang login. Kosong kalau belum pernah nyambung.
name	string	Nama akun Telegram. Kalau kosong, diisi username, nomor, atau ID.
username	string	Username akun tanpa @. Kosong kalau akunnya nggak punya username.
phone	string	Nomor HP akun.
sessionId	string	Pengenal unik sesi.
isConnected	boolean	true kalau sesi udah login dan lagi nyambung ke Telegram.
qrcode	string	Gambar QR dalam bentuk PNG base64, tanpa awalan data:. Ganti kira-kira tiap 30 detik. Kosong kalau udah nyambung, lagi nunggu password, atau QR-nya belum siap.
isPasswordRequired	boolean	true kalau QR udah di-scan tapi akunnya pakai verifikasi dua langkah. Lanjut ke Kirim Password.
passwordHint	string	Petunjuk password yang kamu atur di Telegram. Bisa kosong.
picture	string	Foto profil kecil sebagai data URI (data:image/jpeg;base64,...). Bisa kosong.
webhook	object	Pengaturan webhook sekarang: url dan token. Dua-duanya kosong kalau webhook mati. Lihat Atur Webhook.

Nampilin QR Code

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

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

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

if (isPasswordRequired) {
  // Tampilin form password, terus kirim ke POST /session/password
}

Tips polling

• Panggil endpoint ini tiap 2–3 detik selama nunggu di-scan.
• QR-nya ganti kira-kira tiap 30 detik, jadi selalu tampilin yang paling baru.
• Berhenti polling begitu isConnected jadi true, atau kalau isPasswordRequired jadi true (tinggal minta password).
• Kalau tiba-tiba dapet 404, QR-nya udah kedaluwarsa dan sesinya dihapus, jadi bikin sesi baru.