Dokumentasi API Lengkap untuk Pengembang
API Bulk Gmail Checker menyediakan akses terprogram ke layanan pengecekan akun Google (Gmail) anda. Dengan API ini, Anda dapat:
Catatan: Semua permintaan API memerlukan autentikasi menggunakan token Bearer. Kunci API dibuat secara otomatis saat Anda mengunjungi aplikasi utama kami dan memiliki batas 500.000 permintaan per hari.
https://gmail-validation.mbahbabat.workers.dev
Semua respons API dikembalikan dalam format JSON dengan kode status HTTP yang sesuai.
Semua permintaan API harus menyertakan kunci API yang valid di header Otorisasi menggunakan skema Bearer token.
Kunci API dibuat secara otomatis saat Anda mengunjungi aplikasi utama kami. Tidak perlu registrasi manual!
Hasilkan Otomatis: Kunci API Anda dibuat secara otomatis pada kunjungan pertama dan disimpan di penyimpanan lokal browser Anda.
Sertakan kunci API Anda di header Otorisasi semua permintaan:
Authorization: Bearer KUNCI_API_ANDA_DI_SINI
Penting: Kunci API Anda harus dijaga keamanannya dan tidak terekspos dalam kode sisi klien. Kunci API dibatasi hingga 500.000 permintaan per hari dan akan direset setiap 24 jam.
Untuk alasan keamanan, pembuatan kunci API dibatasi hanya untuk domain resmi kami:
https://mbahbabat.github.io
Permintaan dari domain lain akan ditolak. Ini memastikan bahwa hanya pengguna sah yang dapat membuat dan menggunakan kunci API kami.
Pengecekan status akun Google (Gmail) menggunakan server khusus kami. Kami menawarkan opsi pengecekan normal dan cepat.
Server ini menyediakan informasi status terperinci tetapi memproses alamat Gmail dalam kelompok yang lebih kecil (100 email per permintaan).
Server akan menyediakan informasi status akun terperinci.
| Header | Value | Diperlukan |
|---|---|---|
| Content-Type | application/json | Ya |
| Authorization | Bearer <API_KEY> | Ya |
{
"mail": [
"contoh1@gmail.com",
"contoh2@gmail.com",
"contoh3@gmail.com",
"contoh4@gmail.com",
"contoh5@gmail.com"
]
}
[
{
"email": "contoh1@gmail.com",
"status": "live",
"details": "Active"
},
{
"email": "contoh2@gmail.com",
"status": "verify",
"details": "Requires verification"
},
{
"email": "contoh3@gmail.com",
"status": "disabled",
"details": "non-active"
},
{
"email": "contoh4@gmail.com",
"status": "unregistered",
"details": "not found"
},
{
"email": "contoh5@gmail.com",
"status": "bad",
"details": "verify, disabled, or unregistered"
}
]
| Status | Deskripsi |
|---|---|
| live | Akun yang aktif dan dapat diakses |
| verify | Akun yang memerlukan verifikasi tambahan |
| disabled | Akun yang dinonaktifkan |
| unregistered | Akun yang tidak terdaftar pada platform Google (Gmail) |
| bad | Akun yang dinonaktifkan, tidak terdaftar, atau memerlukan verifikasi. |
Normal Server 2 - Server alternatif dengan fungsi yang sama dengan /check1.
Server ini memproses akun Google (Gmail) dengan sangat cepat dan dalam jumlah besar (10.000 email per permintaan) tetapi hanya mengembalikan status biner (live atau bad).
Fast Server 1 - Memproses batch besar dengan cepat dengan hasil status biner.
Server akan memetakan semua status non-live ke "bad":
| Status Asli | Status Fast Server |
|---|---|
| live | live |
| verify, disabled, unregistered, bad | bad |
Fast Server 2 - Server cepat alternatif dengan fungsi yang sama dengan /fastcheck1.
Pantau penggunaan dan batasan API Anda dengan titik akhir statistik.
Ambil statistik penggunaan untuk kunci API Anda.
| Parameter | Deskripsi | Diperlukan |
|---|---|---|
| key | Kunci API Anda | Ya |
{
"type": "free",
"requestsUsed": 150,
"maxRequests": 500000,
"remainingRequests": 850,
"resetPeriod": "24 hours",
"nextResetUTC": "Mon, 01 Jan 2024 00:00:00 GMT",
"owner": "Anonymous",
"resetTimestamp": 1704067200000
}
| Bidang | Deskripsi |
|---|---|
| type | Jenis API (gratis/berbayar) |
| requestsUsed | Jumlah permintaan yang digunakan pada periode saat ini |
| maxRequests | Permintaan maksimum yang diizinkan dalam periode tersebut |
| remainingRequests | Permintaan yang tersisa pada periode saat ini |
| resetPeriod | Periode setelah batas direset |
| nextResetUTC | Waktu reset berikutnya dalam UTC |
| owner | Pengidentifikasi pemilik kunci API |
| resetTimestamp | Atur ulang waktu berikutnya sebagai stempel waktu |
Berikut adalah contoh cara menggunakan API Bulk Gmail Checker dalam berbagai bahasa pemrograman dan lingkungan.
const API_KEY = 'kunci_api_anda_di_sini';
const SERVER_URL = 'https://gmail-validation.mbahbabat.workers.dev';
// Pengecekan Status Akun Google (Gmail)
async function validateEmails(emails) {
try {
const response = await fetch(`${SERVER_URL}/check1`, {
method: 'POST',
headers: {
'Authorization': `Bearer ${API_KEY}`,
'Content-Type': 'application/json'
},
body: JSON.stringify({
mail: emails
})
});
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${response.statusText}`);
}
const data = await response.json();
return data;
} catch (error) {
console.error('Validation error:', error);
throw error;
}
}
// Dapatkan statistik API
async function getApiStats() {
try {
const response = await fetch(`${SERVER_URL}/stats?key=${API_KEY}`);
if (!response.ok) {
throw new Error(`HTTP ${response.status}: ${response.statusText}`);
}
const data = await response.json();
return data;
} catch (error) {
console.error('Stats error:', error);
throw error;
}
}
// Contoh Penggunaan
const emails = ['test1@gmail.com', 'test2@gmail.com', 'test3@gmail.com'];
validateEmails(emails)
.then(results => console.log('Validation results:', results))
.catch(error => console.error('Error:', error));
#Pengecekan Status Akun Google (Gmail)
curl -X POST "https://gmail-validation.mbahbabat.workers.dev/check1" \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"mail": [
"example1@gmail.com",
"example2@gmail.com",
"example3@gmail.com"
]
}'
# Dapatkan statistik API
curl "https://gmail-validation.mbahbabat.workers.dev/stats?key=YOUR_API_KEY"
import requests
API_KEY = 'kunci_api_anda_di_sini'
SERVER_URL = 'https://gmail-validation.mbahbabat.workers.dev'
def validate_emails(emails):
headers = {
'Authorization': f'Bearer {API_KEY}',
'Content-Type': 'application/json'
}
data = {
'mail': emails
}
response = requests.post(f'{SERVER_URL}/check1', headers=headers, json=data)
response.raise_for_status()
return response.json()
def get_api_stats():
response = requests.get(f'{SERVER_URL}/stats?key={API_KEY}')
response.raise_for_status()
return response.json()
# Contoh Penggunaan
emails = ['test1@gmail.com', 'test2@gmail.com', 'test3@gmail.com']
try:
results = validate_emails(emails)
print('Validation results:', results)
except requests.exceptions.RequestException as e:
print('Error:', e)
$api_key = 'your_api_key_here';
$server_url = 'https://gmail-validation.mbahbabat.workers.dev';
// Pengecekan Status Akun Google (Gmail)
function validateEmails($emails) {
global $api_key, $server_url;
$data = json_encode(['mail' => $emails]);
$ch = curl_init("$server_url/check1");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
"Authorization: Bearer $api_key",
"Content-Type: application/json"
]);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code !== 200) {
throw new Exception("HTTP $http_code: $response");
}
return json_decode($response, true);
}
// Dapatkan Statistik API
function getApiStats() {
global $api_key, $server_url;
$ch = curl_init("$server_url/stats?key=$api_key");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($http_code !== 200) {
throw new Exception("HTTP $http_code: $response");
}
return json_decode($response, true);
}
// Contoh Penggunaan
$emails = ['test1@gmail.com', 'test2@gmail.com', 'test3@gmail.com'];
try {
$results = validateEmails($emails);
echo 'Validation results: ' . print_r($results, true);
} catch (Exception $e) {
echo 'Error: ' . $e->getMessage();
}