API untuk website kamu

Pakai API key ini hanya di backend/server milikmu. Jangan taruh di HTML atau JavaScript browser publik. Semua request harus melalui HTTPS.

Mengganti key langsung menonaktifkan key lama. Perbarui konfigurasi backend-mu setelah menggantinya.

Dokumentasi singkat

Base URL: https://gmailchecker.my.id · Header: Authorization: Bearer API_KEY_ANDA

1. Lihat saldo

curl -H "Authorization: Bearer API_KEY_ANDA" \
  https://gmailchecker.my.id/api/v1/balance

Respons sukses · HTTP 200:

{
  "ok": true,
  "balance": 50000,
  "currency": "IDR",
  "pricePerLogin": 30,
  "pricePerCaptcha": 30,
  "canCheckEmails": 1666,
  "status": "active"
}

Contoh dari backend Node.js (simpan key di environment server):

const response = await fetch('https://gmailchecker.my.id/api/v1/balance', {
  headers: { Authorization: `Bearer ${process.env.GMAILCHECKER_API_KEY}` }
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
const { balance } = await response.json();

2. Cek email

curl --no-buffer -X POST https://gmailchecker.my.id/api/v1/check \
  -H "Authorization: Bearer API_KEY_ANDA" \
  -H "Content-Type: application/json" \
  -d '{"emails":["contoh@gmail.com"]}'

Respons sukses · HTTP 200, application/x-ndjson. Setiap baris adalah satu objek JSON. Event start dan progress menunjukkan proses; hanya event done dengan ok:true yang merupakan hasil final. Event phase juga bisa muncul di tengah proses.

{"type":"start","total":1,"checking":1,"skippedSaldo":0,"pricePerLogin":30,"pricePerCaptcha":30}
{"type":"progress","email":"contoh@gmail.com","status":"login","done":1,"total":1}
{"type":"done","ok":true,"total":1,"checked":1,"partial":false,"pricePerLogin":30,"pricePerCaptcha":30,"billableCount":1,"charged":30,"balanceBefore":50000,"balanceAfter":49970,"paused":false,"elapsedMs":4200,"counts":{"login":1,"unregistered":0,"verify":0,"disabled":0,"captcha":0,"gagal_dicek":0},"categories":{"login":["contoh@gmail.com"],"unregistered":[],"verify":[],"disabled":[],"captcha":[],"gagal_dicek":{"sistem":[],"saldo_kurang":[]}}}

charged adalah biaya dalam rupiah. balanceAfter adalah saldo setelah pengecekan. LOGIN dan CAPTCHA ditagih; VERIFY, DISABLED, UNREGISTERED, dan error sistem tidak ditagih. Jika koneksi putus sebelum done, jangan anggap hasil sukses—cek ulang saldo dan riwayat.

Contoh kesalahan

HTTP 401  {"ok":false,"error":"API key tidak valid."}
HTTP 402  {"error":"Saldo tidak cukup. Isi saldo dulu...","balance":0}
HTTP 429  {"error":"Masih ada request lain diproses untuk key ini..."}
HTTP 200  {"type":"error","message":"Gagal memproses pengecekan email."}

Saldo selalu dibaca dari akun pemilik key. Tidak ada parameter ID pengguna lain. API ini untuk backend; request langsung dari browser pengguna lain tidak didukung.