Berapa biaya satu verifikasi API?

Satu POST /verify sukses menggunakan tepat 1 credit. Permintaan GET (saldo, riwayat) gratis. Kredit tidak kedaluwarsa — beli sesuai kebutuhan.

Bisakah memverifikasi email yang sama berkali-kali?

Ya. Setiap panggilan API /verify memakai 1 credit, meski alamat sama. Billing tetap prediktif dan selaras dengan penggunaan aktual.

Bagaimana membuat kunci API?

Buat akun, buka API tokens (/account/api), klik «New token» dan salin secret ev_live_… atau ev_test_… (sandbox). Kunci lengkap hanya ditampilkan sekali.

Apakah API mendukung verifikasi bulk email?

Ya. POST /bulk menerima hingga 50.000 alamat. Biaya N kredit untuk N email. Lacak progres via GET /bulk/:id dan unduh CSV.

Apa arti valid, invalid, dan risky?

valid — siap kirim; invalid — hapus; risky — disposable atau role account; catch_all — domain menerima semua alamat. Lihat bagian Status.

Apakah ada batas permintaan per menit?

Default 60 permintaan/menit per kunci API. Respons 429 mengembalikan error: rate_limit_exceeded. Gunakan Idempotency-Key saat retry POST /verify.

Di mana spesifikasi OpenAPI lengkap?

Unduh openapi-v1.yaml di /api/v1/openapi.yaml atau Redoc interaktif di /id/dokumentacja-api/reference.

Pusat pengembang · REST API v1

API verifikasi alamat email

Verifikasi mailing list secara programatik — bounce lebih sedikit, deliverability lebih baik

Hubungkan formulir pendaftaran, CRM, dan landing page ke EmailVerifier. Periksa alamat email via REST API real-time atau job bulk — billing transparan 1 request = 1 credit.

Verifikasi real-time
Bulk hingga 50.000 email
1 permintaan = 1 kredit

Buat kunci API Buat akun OpenAPI / Redoc

Contoh permintaan

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_…" \
  -d '{"email":"user@company.com"}'

Basis pengetahuan API

Pilih topik — dari autentikasi dan kredit hingga job bulk, webhooks, dan kode error.

APIAPI verifikasi email

POST /verify — satu alamat, hasil sub-detik, status valid/invalid/risky.

Baca selengkapnya

APIVerifikasi bulk email

Verifikasi massal daftar CSV — antrian job, polling progres, dan ekspor CSV.

Baca selengkapnya

APIKredit dan billing

Saldo, penggunaan API, 1 credit = 1 verifikasi, penanganan HTTP 402.

Baca selengkapnya

APIKunci API dan autentikasi

Bearer ev_live_, panel token, praktik terbaik penyimpanan kunci aman.

Baca selengkapnya

APIWebhooks dan integrasi

verification.completed, tanda tangan HMAC, CRM dan otomasi marketing.

Baca selengkapnya

APIReferensi OpenAPI

Spesifikasi YAML lengkap, UI Redoc, dan katalog error HTTP.

Baca selengkapnya

Apa itu API verifikasi email?

Antarmuka REST untuk memvalidasi alamat sebelum mengirim kampanye.

API verifikasi email memeriksa apakah alamat ada, domain menerima mail, dan inbox bukan disposable atau catch-all. Anda mengurangi bounce rate, melindungi reputasi pengirim, dan meningkatkan inbox placement.

API dilayani via HTTPS di /api/v1. Autentikasi dengan kunci Bearer (ev_live_…) atau sesi dashboard. Setiap POST /verify sukses memakan satu credit — tanpa langganan dan tanpa biaya tersembunyi untuk GET.

Kapan menggunakan API validator email

Skenario integrasi umum di produk B2B dan stack marketing.

Formulir pendaftaran

Validasi email real-time saat registrasi — tolak invalid dan disposable sebelum masuk daftar.

CRM dan lead capture

Bersihkan lead dari landing page dan webhook — hanya alamat terkirim masuk pipeline.

Higiene daftar sebelum kampanye

Bulk API sebelum newsletter — bounce lebih sedikit, open rate lebih tinggi, biaya ESP lebih rendah.

Platform SaaS

Sematkan pemeriksaan email di produk — billing berbasis credit menyederhanakan harga pelanggan.

Model kredit API

Harga sederhana: satu permintaan verifikasi = satu credit.

POST /verify mengenakan 1 credit per permintaan sukses (HTTP 200) dengan kunci ev_live_, meski alamat sama pernah diverifikasi via API. Kunci sandbox (ev_test_) mengembalikan mock tanpa debit kredit.
Operasi GET — saldo, riwayat, status job bulk, ekspor CSV — gratis.
Saldo tidak cukup mengembalikan HTTP 402 (insufficient_credits). Error mesin (503) tidak mengenakan credit.

Autentikasi dan kunci API

Akses aman via header Authorization.

Masuk ke dashboard dan buka API tokens (/account/api).
Buat kunci produksi (ev_live_) atau sandbox (ev_test_) di panel — secret lengkap hanya ditampilkan sekali.
Kirim kunci sebagai Authorization: Bearer ev_live_… — jangan di URL atau kode klien.

Authorization: Bearer ev_live_YOUR_API_KEY
Content-Type: application/json

Mulai cepat — API verifikasi email

Dua panggilan: cek saldo dan verifikasi pertama.

1. Cek saldo kredit

curl https://propercheck.pl/api/v1/credits \
  -H "Authorization: Bearer ev_live_YOUR_KEY"

2. Verifikasi satu alamat email

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

Verifikasi tunggal (real-time)

POST /api/v1/verify menerima JSON dengan field email. Respons mencakup status, score 0–100, provider (Google, Microsoft, host regional) dan enrichment (MX, catch-all).

POST /api/v1/verify

Struktur respons JSON

Field yang dikembalikan setelah verifikasi sukses.

{
  "verificationId": "ver_abc123",
  "email": "john@company.com",
  "status": "valid",
  "score": 92,
  "provider": "google",
  "enrichment": { "mxRecords": ["aspmx.l.google.com"], "catchAll": false },
  "creditsRemaining": 149
}

Status verifikasi email

Klasifikasi di API, dashboard, dan ekspor CSV.

valid

valid — alamat ada dan dapat menerima mail; aman untuk dikirim.

invalid

invalid — alamat tidak ada atau domain tanpa mail; hapus dari daftar.

risky

risky — confidence rendah (mis. disposable, role account); hati-hati di kampanye.

catch_all

catch_all — server menerima semua alamat domain; risiko bounce lebih tinggi.

unknown

unknown — respons SMTP tidak conclusive; pertimbangkan verifikasi ulang nanti.

Referensi endpoint REST

Daftar path API v1 lengkap dengan biaya credit.

Metode	Path	Kredit	Deskripsi
POST	/verify	1	Verifikasi email tunggal real-time
GET	/verify/:id	0	Ambil hasil via verificationId
GET	/verifications	0	Riwayat verifikasi dan statistik 30 hari
GET	/credits	0	Saldo kredit akun saat ini
POST	/bulk	N	Buat job bulk (N kredit)
GET	/bulk/:id	0	Status dan progres job bulk
GET	/bulk/:id/export	0	Unduh hasil sebagai CSV
GET/POST/PATCH/DELETE	/api-keys	0	Manajemen token API (sesi)
GET/POST/DELETE	/webhooks	0	Konfigurasi webhook (sesi)
GET	/usage	0	Statistik penggunaan API dan kredit

API verifikasi email massal

Verifikasi ribuan alamat dalam satu job — ideal sebelum kampanye besar.

POST /bulk dengan array emails atau teks CSV — kredit dicadangkan untuk N alamat unik.
GET /bulk/:id — polling status (queued → processing → completed).
GET /bulk/:id/export — unduh CSV dengan kolom email, status, score, provider.

curl -X POST https://propercheck.pl/api/v1/bulk \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"emails":["a@b.co","c@d.co"]}'

Webhook — verification.completed

Terima POST ke URL Anda saat verifikasi selesai. Header X-EV-Signature berisi HMAC-SHA256 body — verifikasi sebelum memproses.

X-EV-Event: verification.completed
X-EV-Signature: <hmac-sha256 of body>

Batas laju

Default 60 permintaan per menit per kunci API. Melebihi mengembalikan HTTP 429 dengan rate_limit_exceeded. Batas per kunci — token terpisah per integrasi.

Header opsional pada POST /verify — retry aman tanpa debit credit ganda untuk kunci sama (TTL 24 jam).

X-Request-Id

Setiap respons API menyertakan X-Request-Id — sertakan saat menghubungi support untuk debugging integrasi.

Kode error HTTP

HTTP	Kode	Deskripsi
401	unauthorized	Sesi atau kunci API hilang dalam permintaan.
401	invalid_api_key	Kunci API tidak valid, kedaluwarsa, atau dicabut.
400	invalid_request	JSON tidak valid, field email hilang, atau alamat malformed.
402	insufficient_credits	Kredit tidak cukup — isi ulang di /account/credits.
429	rate_limit_exceeded	Rate limit terlampaui — default 60 permintaan/menit per kunci API.
503	engine_unavailable	Mesin verifikasi tidak tersedia — credit tidak dikenakan.

Contoh integrasi

Alur verifikasi yang sama dalam bahasa populer.

curl -X POST https://propercheck.pl/api/v1/verify \
  -H "Authorization: Bearer ev_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"john@company.com"}'

FAQ — API verifikasi email

Pertanyaan umum dari developer dan marketer.

OpenAPI 3.1 dan Redoc

Spesifikasi machine-readable untuk codegen, contract test, dan pipeline CI.

Unduh openapi-v1.yaml Referensi Redoc interaktif

Mulai verifikasi email via API

Kredit uji coba gratis saat mendaftar. Kunci API di dashboard dalam satu menit.

Buat akun Token API

Buat kunci di panel akun.