Dokumen API Validasi Email

Status API

Memulai

Semua permintaan API memerlukan autentikasi menggunakan kunci API. Anda dapat menemukan kunci API di dasbor.

Header: "x-api-key: kunci-api Anda"

Verifikasi Tunggal

Verifikasi satu alamat email atau domain untuk validitas, status sekali pakai, layanan privasi, dan pengiriman.

Titik akhir

GET /v1/verify

Parameter

Nama	Jenis	Diperlukan	Deskripsi
input	string	Ya.	Alamat email atau domain untuk memverifikasi (misalnya, test@example.com atau example.com)

Bidang Respons

Bidang	Deskripsi
valid	Menunjukkan apakah format email sudah benar
block	Menunjukkan apakah email harus diblokir (benar jika disposable, privacy, applePrivateEmail, deliverable, atau catch_all benar)
disposable	Menentukan apakah alamat email adalah alamat email sementara atau sekali pakai
privacy	Menentukan apakah server email menggunakan email alias atau forwarder
applePrivateEmail	Menunjukkan apakah email tersebut merupakan alamat email Pribadi Apple
deliverable	Memeriksa apakah kotak surat ada dan dapat menerima email
domain	Bagian domain dari alamat email
email_address	Alamat email
catch_all	Menunjukkan apakah domain memiliki konfigurasi email semua yang menerima semua email masuk tanpa memandang alamat penerima
mx_found	Menunjukkan apakah domain memiliki server email yang valid (catatan MX)
remaining_credits	Jumlah kredit API yang tersisa di akun Anda

Daftar Hitam / Daftar Putih: Hanya bidang blokir yang mencerminkan keanggotaan daftar. Daftar hitam → blokir: benar; daftar putih → blokir: salah; tidak ada dalam daftar putih (bila diaktifkan) → blokir: benar. Jangan gunakan valid untuk memutuskan apakah akan memblokir berdasarkan daftar.

Contoh Tanggapan

{
  "valid": true,
  "block": false,
  "disposable": false,
  "privacy": false,
  "applePrivateEmail": false,
  "deliverable": true,
  "domain": "example.com",
  "email_address": "test@example.com",
  "catch_all": false,
  "mx_found": true,
  "error": null,
  "remaining_credits": 99
}

Contoh Kode

curl "https://api.verify-email.app/v1/verify?input=test@example.com" \
  -H "X-API-Key: your-api-key"

Cobalah

Kunci API

Anda memerlukan kunci API untuk menguji titik akhir.

Alamat email atau domain

Coba dengan:

Verifikasi Batch

Verifikasi beberapa alamat email atau domain dalam satu permintaan (maksimal 100 item).

Titik akhir

POST /v1/verify/batch

Parameter

Nama	Jenis	Diperlukan	Deskripsi
inputs	array of strings	Ya.	Array alamat email atau domain untuk diverifikasi

Contoh Kode

curl -X POST "https://api.verify-email.app/v1/verify/batch" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: your-api-key" \
  -d '{
    "inputs": [
      "test1@example.com",
      "test2@example.com"
    ]
  }'

Cobalah

Kunci API

Anda memerlukan kunci API untuk menguji titik akhir.

Alamat email atau domain

Coba dengan domain yang berbeda:

Pemeriksaan Khusus Kiriman

Pemeriksaan keterkiriman email yang cepat menggunakan verifikasi MX dan SMTP tanpa panggilan API eksternal. Hanya mengembalikan bidang yang terkait dengan keterkiriman untuk waktu respons yang lebih cepat.

Titik akhir

GET /v1/verify/deliverable

Parameter

Nama	Jenis	Diperlukan	Deskripsi
input	string	Ya.	Alamat email untuk memeriksa keterkiriman (misalnya, test@example.com). Masukan khusus domain tidak didukung untuk titik akhir ini.

Bidang Respons

Bidang	Deskripsi
valid	Menunjukkan apakah format email sudah benar
deliverable	Memeriksa apakah kotak surat ada dan dapat menerima email
mx_found	Menunjukkan apakah domain memiliki server email yang valid (catatan MX)
catch_all	Menunjukkan apakah domain memiliki konfigurasi email semua yang menerima semua email masuk tanpa memandang alamat penerima
email_address	Alamat email
remaining_credits	Jumlah kredit API yang tersisa di akun Anda

Contoh Tanggapan

{
  "valid": true,
  "deliverable": true,
  "mx_found": true,
  "catch_all": false,
  "email_address": "test@example.com",
  "remaining_credits": 99
}

Contoh Kode

curl "https://api.verify-email.app/v1/verify/deliverable?input=test@example.com" \
  -H "X-API-Key: your-api-key"

Cobalah

Kunci API

Anda memerlukan kunci API untuk menguji titik akhir.

Alamat email atau domain

Coba dengan:

Daftar putih & daftar hitam

Kendalikan email dan domain mana yang diblokir dengan aturan daftar hitam dan putih per pengguna. Daftar ini mengatur field block di setiap respons verifikasi.

{}

Field block

Setiap respons verifikasi berisi field block. Gunakan field ini untuk memutuskan apakah email/domain harus diblokir berdasarkan daftar Anda:

trueEmail atau domainnya ada di daftar hitam → block: true. Menambah domain memblokir semua email pada domain itu.

trueDaftar putih aktif tapi email/domain tidak ada di dalamnya → block: true.

falseDaftar putih aktif dan email atau domainnya ada di dalamnya → block: false.

—Tidak ada daftar yang berlaku → block mengikuti hasil verifikasi normal.

Ikhtisar

✘

Daftar hitam

Selalu blokir email atau domain tertentu. Misalnya menambah example.com ke daftar hitam berarti email @example.com mana pun akan mengembalikan block: true — apa pun hasil verifikasinya.

✔

Daftar putih

Hanya izinkan email atau domain tertentu. Saat daftar putih aktif, hanya entri yang terdaftar yang dapat block: false — sisanya block: true. Misalnya menambah gmail.com mengizinkan @gmail.com mana pun, tapi user@yahoo.com akan diblokir. Saat dinonaktifkan, daftar putih tidak berpengaruh.

Anda bisa menambah email lengkap (user@example.com) atau domain (example.com). Menambah domain berlaku untuk setiap email pada domain itu. Nilai tidak membedakan huruf besar/kecil.

Cara kerja

Urutan evaluasi

Daftar hitam dulu — Jika alamat email atau domainnya ada di daftar hitam, hasilnya block: true. Logika daftar lain tidak diterapkan.

Daftar putih (jika aktif) — Jika email/domain ada di daftar putih → block: false. Jika tidak → block: true.

Daftar putih nonaktif — Hanya daftar hitam dan verifikasi normal yang berlaku.

Daftar hitam selalu menang: alamat di daftar hitam tetap diblokir meski juga ada di daftar putih.

Yang dicocokkan

Verifikasi email — API memeriksa alamat lengkap dan domain terhadap kedua daftar. Kecocokan menerapkan aturan daftar.

Verifikasi domain — hanya domain yang diperiksa terhadap daftar hitam dan (jika aktif) daftar putih.

Referensi singkat

Daftar putih aktif	Di daftar hitam	Di daftar putih	nilai block
Tidak	Ya	—	`true`
Tidak	Tidak	—	Normal
Ya	Ya	Apa saja	`true`
Ya	Tidak	Ya	`false`
Ya	Tidak	Tidak	`true`

Endpoint daftar API

Semua endpoint daftar memerlukan header: X-API-Key: your-api-key

Daftar hitam

GET/v1/blacklist

Daftar semua entri daftar hitam

POST/v1/blacklist

Tambah email atau domain · { "value": "..." }

DELETE/v1/blacklist

Hapus entri · value=...

Daftar putih

GET/v1/whitelist

Daftar semua entri daftar putih

POST/v1/whitelist

Tambah email atau domain · { "value": "..." }

DELETE/v1/whitelist

Hapus entri · value=...

GET/v1/whitelist/enabled

Dapatkan status daftar putih · { "enabled": boolean }

PUT/v1/whitelist/enabled

Aktifkan/nonaktifkan daftar putih · { "enabled": true | false }

Format nilai

user@example.com — Email: format valid, mis. user@example.com
example.com — Domain: format valid, mis. example.com

Nilai tidak valid ditolak dengan 400. Entri disimpan ternormalisasi. Duplikat digabung jadi satu entri.

Di mana daftar diterapkan

Aturan daftar diterapkan setelah verifikasi. Respons verifikasi email (tunggal dan batch) dan domain sudah menyertakan daftar hitam dan putih pengguna di field block.

Server MCP (Integrasi Agen AI)

Integrasikan verifikasi email secara langsung ke dalam agen AI seperti Cursor dan Claude Desktop menggunakan Model Context Protocol (MCP). Asisten AI Anda dapat memverifikasi email, memeriksa domain, dan memvalidasi sintaks tanpa meninggalkan editor.

Pengaturan

Tambahkan konfigurasi berikut ini ke .cursor/mcp.json atau file konfigurasi Claude Desktop:

{
  "mcpServers": {
    "email-checker": {
      "url": "https://api.verify-email.app/mcp",
      "headers": {
        "X-API-Key": "your-api-key"
      }
    }
  }
}

Alat yang Tersedia

Alat	Deskripsi	Masukan	Kredit
verify_email	Verifikasi email lengkap termasuk pemeriksaan sintaksis, MX, SMTP, sekali pakai, privasi, dan keterkiriman	{ email: string }	1
verify_domain	Verifikasi domain lengkap termasuk catatan MX, sekali pakai, privasi, dan deteksi semua	{ domain: string }	1
check_deliverability	Pemeriksaan pengiriman cepat-hanya menggunakan verifikasi MX dan SMTP tanpa panggilan API eksternal	{ email: string }	1
verify_batch	Verifikasi batch hingga 100 email atau domain dalam satu permintaan	{ inputs: string[] }	1 per item
validate_email_syntax	Validasi sintaksis lokal yang cepat terhadap RFC 5322 tanpa panggilan jaringan	{ email: string }	0 (free)