BULK GMAIL CHECKER API v.1

Dokumentasi API Lengkap untuk Pengembang

REST API JSON Bearer Token

Ringkasan API

API Bulk Gmail Checker menyediakan akses terprogram ke layanan pengecekan akun Google (Gmail) anda. Dengan API ini, Anda dapat:

  • Pengecekan status akun Google (Gmail) secara massal
  • Jenis status (Live, Verify, Disabled, Unregistered, Bad)
  • Pantau statistik penggunaan API Anda
  • Integrasikan Pengecekan status akun Google (Gmail) ke dalam aplikasi Anda

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.

URL Dasar

https://gmail-validation.mbahbabat.workers.dev

Format Respon

Semua respons API dikembalikan dalam format JSON dengan kode status HTTP yang sesuai.

Autentikasi

Semua permintaan API harus menyertakan kunci API yang valid di header Otorisasi menggunakan skema Bearer token.

GET Pembuatan Kunci API Otomatis

Kunci API dibuat secara otomatis saat Anda mengunjungi aplikasi utama kami. Tidak perlu registrasi manual!

Cara Mendapatkan Kunci API Anda

  1. Kunjungi Bulk Gmail Checker
  2. Klik tombol "AKUN SAYA" di pojok kanan atas
  3. Kunci API Anda akan secara otomatis dibuat dan ditampilkan di bagian "Kunci API"
  4. Salin kunci API untuk digunakan di aplikasi Anda

Hasilkan Otomatis: Kunci API Anda dibuat secara otomatis pada kunjungan pertama dan disimpan di penyimpanan lokal browser Anda.

Menggunakan Kunci API 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.

Keamanan & Batasan Origin

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.

Endpoint Pengecekan Status Akun Google (Gmail)

Pengecekan status akun Google (Gmail) menggunakan server khusus kami. Kami menawarkan opsi pengecekan normal dan cepat.

Normal Servers 1

Server ini menyediakan informasi status terperinci tetapi memproses alamat Gmail dalam kelompok yang lebih kecil (100 email per permintaan).

POST /check1

Server akan menyediakan informasi status akun terperinci.

Request Headers

Header Value Diperlukan
Content-Type application/json Ya
Authorization Bearer <API_KEY> Ya

Request Body

{
	  "mail": [
		"contoh1@gmail.com",
		"contoh2@gmail.com",
		"contoh3@gmail.com",
		"contoh4@gmail.com",
		"contoh5@gmail.com"	
	  ]
	}

Respon

[
	  {
		"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"
	  }
	]

Jenis Status

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.
POST /check2

Normal Server 2 - Server alternatif dengan fungsi yang sama dengan /check1.

Fast Server

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).

POST /fastcheck1

Fast Server 1 - Memproses batch besar dengan cepat dengan hasil status biner.

Pemetaan Status untuk Fast Server

Server akan memetakan semua status non-live ke "bad":

Status Asli Status Fast Server
live live
verify, disabled, unregistered, bad bad
POST /fastcheck2

Fast Server 2 - Server cepat alternatif dengan fungsi yang sama dengan /fastcheck1.

Statistik API

Pantau penggunaan dan batasan API Anda dengan titik akhir statistik.

GET /stats?key=<API_KEY>

Ambil statistik penggunaan untuk kunci API Anda.

Query Parameters

Parameter Deskripsi Diperlukan
key Kunci API Anda Ya

Respon

{
	  "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 Respon

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

Contoh Kode

Berikut adalah contoh cara menggunakan API Bulk Gmail Checker dalam berbagai bahasa pemrograman dan lingkungan.

JavaScript (Fetch API)

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));

cURL

#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"

Python

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)

PHP

$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();
	}