CekGmail — Pemeriksa Keaktifan Gmail Massal & Spesifikasi Lengkap Public Developer REST API (v1)

Halaman ini memuat seluruh spesifikasi resmi endpoint, parameter request, format response JSON, serta contoh kode lengkap integrasi Public Developer REST API (/api/v1) tanpa memerlukan file eksternal tambahan.

1. Base URL & Autentikasi API Key

  • Base URL API: https://www.cekgmail.alfzixciogmail.web.id/api/v1 (atau /api/v1 pada domain aktif)
  • Cara mendapatkan API Key: Login ke akun Anda di web, lalu buka menu API Key Saya untuk membuat API Key dengan format cgp_live_....
  • Kirim API Key menggunakan salah satu dari 3 cara berikut:
    • Header HTTP (Utama): X-API-Key: cgp_live_YOUR_API_KEY
    • Header Bearer: Authorization: Bearer cgp_live_YOUR_API_KEY
    • Query Parameter URL: ?apikey=cgp_live_YOUR_API_KEY

2. Daftar Endpoint API, Format Request & Response JSON Lengkap

Endpoint 1: Cek Status Maintenance Web & API — GET /api/v1/maintenance

  • Method & URL: GET https://www.cekgmail.alfzixciogmail.web.id/api/v1/maintenance (Alias: GET /api/v1/status, POST /api/v1/maintenance)
  • Autentikasi: Opsional (Jika menyertakan header X-API-Key, API akan mengecek apakah akun pemilik API Key masuk daftar Pilih Users / Bebas Maintenance).
  • Perilaku Maintenance: Saat Web Maintenance diaktifkan oleh Admin, maka API juga otomatis Maintenance (mengembalikan HTTP 503 MAINTENANCE_MODE beserta reason), kecuali untuk API Key milik akun yang dipilih bebas maintenance (tetap HTTP 200 "exempt": true, "can_access_api": true).

Format Response JSON saat Normal (HTTP 200):

{
  "ok": true,
  "status": "ACTIVE",
  "maintenance": false,
  "web_maintenance": false,
  "api_maintenance": false,
  "exempt": false,
  "can_access_api": true,
  "reason": null,
  "message": "Layanan web dan API aktif normal."
}

Format Response JSON saat Maintenance Aktif (HTTP 503):

{
  "ok": false,
  "error": "MAINTENANCE_MODE",
  "status": "MAINTENANCE",
  "maintenance": true,
  "web_maintenance": true,
  "api_maintenance": true,
  "exempt": false,
  "can_access_api": false,
  "reason": "Kami sedang melakukan pemeliharaan dan peningkatan sistem. Silakan coba beberapa saat lagi.",
  "message": "Sistem sedang dalam mode maintenance: Kami sedang melakukan pemeliharaan dan peningkatan sistem. Silakan coba beberapa saat lagi."
}

Endpoint 2: Cek Saldo, Informasi Akun & Tarif — GET /api/v1/balance (Alias: GET /api/v1/me, GET /api/v1/account)

  • Method & URL: GET https://www.cekgmail.alfzixciogmail.web.id/api/v1/balance
  • GET URL Cepat: GET https://www.cekgmail.alfzixciogmail.web.id/api/v1/balance?apikey=cgp_live_YOUR_API_KEY
  • Header: X-API-Key: cgp_live_YOUR_API_KEY

Format Response JSON (HTTP 200):

{
  "ok": true,
  "key_name": "My Bot",
  "status": "ACTIVE",
  "owner": "Budi",
  "balance": 28300,
  "currency": "IDR",
  "price": 33,
  "maintenance": false,
  "web_maintenance": false,
  "api_maintenance": false,
  "maintenance_exempt": false,
  "billable_statuses": ["LOGIN", "CAPTCHA"],
  "free_statuses": ["VERIFY", "DISABLED", "DIE", "UNREGISTERED"],
  "limits": {
    "max_emails_per_request": 100,
    "rate_limit_per_minute": 60
  }
}

Endpoint 3: Pemeriksaan 1 Email (Single Check) — POST /api/v1/check

  • Method & URL: POST https://www.cekgmail.alfzixciogmail.web.id/api/v1/check
  • Alternatif GET URL: GET https://www.cekgmail.alfzixciogmail.web.id/api/v1/check?email=example@gmail.com&apikey=cgp_live_YOUR_API_KEY
  • Headers: Content-Type: application/json, X-API-Key: cgp_live_YOUR_API_KEY
  • Request Body JSON (1 Email): {"email": "example@gmail.com"}

Format Response JSON (HTTP 200):

{
  "ok": true,
  "email": "example@gmail.com",
  "status": "LOGIN",
  "billable": true,
  "cost": 33,
  "balance": 28267,
  "message": "Akun aktif siap login"
}

Endpoint 4: Pemeriksaan Massal / Bulk (1 s/d 100 Email) — POST /api/v1/check

  • Method & URL: POST https://www.cekgmail.alfzixciogmail.web.id/api/v1/check
  • Headers: Content-Type: application/json, X-API-Key: cgp_live_YOUR_API_KEY
  • Request Body JSON (Massal): {"emails": ["user1@gmail.com", "user2@gmail.com"]} (maksimal 100 email per request)

Format Response JSON (HTTP 200):

{
  "ok": true,
  "total": 2,
  "summary": {
    "login": 1,
    "captcha": 0,
    "verify": 0,
    "disabled": 0,
    "die": 1,
    "unregistered": 0,
    "error": 0
  },
  "cost": 33,
  "balance": 28267,
  "results": [
    {
      "email": "user1@gmail.com",
      "status": "LOGIN",
      "billable": true,
      "cost": 33,
      "message": "Akun aktif siap login"
    },
    {
      "email": "user2@gmail.com",
      "status": "DIE",
      "billable": false,
      "cost": 0,
      "message": "Akun tidak ditemukan atau mati"
    }
  ]
}

3. Aturan Tarif Status & Kode Error HTTP

  • Status Berbayar (Rp 33 / email): LOGIN, CAPTCHA
  • Status Gratis (Rp 0): VERIFY, DISABLED, DIE, UNREGISTERED, ERROR
  • Batas Batch & Rate Limit: Maksimal 100 email/request, 60 request/menit
  • HTTP 401: MISSING_API_KEY / INVALID_API_KEY
  • HTTP 402: INSUFFICIENT_BALANCE
  • HTTP 403: KEY_INACTIVE / USER_API_DISABLED / ACCOUNT_SUSPENDED
  • HTTP 400: EMPTY_EMAILS / TOO_MANY_EMAILS
  • HTTP 429: RATE_LIMIT_EXCEEDED
  • HTTP 503: MAINTENANCE_MODE (Web & API sedang maintenance; alasan tersedia di field reason) / API_DISABLED

4. Kode Siap Pakai Python Web 1 File (Flask — app.py)

Kode app.py berikut langsung terhubung ke endpoint resmi GET /api/v1/maintenance, GET /api/v1/balance, dan POST /api/v1/check (mendukung setting API Key di web, tampil saldo & status maintenance, serta cek 1 atau banyak email):

import os
import requests
from flask import Flask, request, jsonify, render_template_string

app = Flask(__name__)
CONFIG = {
    "base_url": os.getenv("CEKGMAIL_BASE_URL", "https://www.cekgmail.alfzixciogmail.web.id/api/v1"),
    "api_key": os.getenv("CEKGMAIL_API_KEY", "cgp_live_YOUR_API_KEY"),
}

@app.get("/api/info")
def api_info():
    headers = {"X-API-Key": CONFIG["api_key"]}
    maint = requests.get(f"{CONFIG['base_url']}/maintenance", headers=headers, timeout=15).json()
    balance = requests.get(f"{CONFIG['base_url']}/balance", headers=headers, timeout=15).json()
    return jsonify({"maintenance": maint, "balance": balance})

@app.post("/api/config")
def api_config():
    data = request.get_json(silent=True) or {}
    if data.get("api_key"):
        CONFIG["api_key"] = str(data["api_key"]).strip()
    return jsonify({"ok": True})

@app.post("/api/check")
def api_check():
    data = request.get_json(silent=True) or {}
    emails = [str(e).strip() for e in (data.get("emails") or []) if str(e).strip()]
    payload = {"email": emails[0]} if len(emails) == 1 else {"emails": emails}
    r = requests.post(
        f"{CONFIG['base_url']}/check",
        headers={"Content-Type": "application/json", "X-API-Key": CONFIG["api_key"]},
        json=payload,
        timeout=120,
    )
    return jsonify(r.json()), r.status_code

if __name__ == "__main__":
    app.run(host="0.0.0.0", port=5000, debug=True)