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/v1pada 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
- Header HTTP (Utama):
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_MODEbesertareason), 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 fieldreason) /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)