UNTUK DEVELOPER

API verifikasi email.

Gunakan pemeriksaan satu alamat untuk formulir, atau tugas asinkron untuk daftar klien. Tetap gunakan penyedia email Anda saat ini.

MULAI DENGAN SATU ALAMAT

Permintaan pertama Anda.

Gunakan endpoint demo gratis tanpa kunci. Endpoint ini memiliki batas permintaan dan ditujukan untuk mencoba layanan.

curl -X POST https://api.zbounce.net/v1/demo \
  -H 'Content-Type: application/json' \
  -d '{"email":"hello@example.com"}'

Untuk pemeriksaan berbayar, beli paket dan gunakan /v1/fast-verify dengan kunci Anda di X-API-Key. Jangan cantumkan kunci di URL, kontrol sumber, atau analitik.

curl -X POST https://api.zbounce.net/v1/fast-verify \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $ZBOUNCE_API_KEY" \
  -d '{"email":"hello@example.com"}'

Contoh Python

import os, requests

response = requests.post(
    "https://api.zbounce.net/v1/fast-verify",
    headers={"X-API-Key": os.environ["ZBOUNCE_API_KEY"]},
    json={"email": "hello@example.com"},
    timeout=35,
)
response.raise_for_status()
print(response.json())

Contoh Node.js

const response = await fetch("https://api.zbounce.net/v1/fast-verify", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "X-API-Key": process.env.ZBOUNCE_API_KEY,
  },
  body: JSON.stringify({ email: "hello@example.com" }),
  signal: AbortSignal.timeout(35000),
});
if (!response.ok) throw new Error(`HTTP ${response.status}`);
console.log(await response.json());

DAFTAR MASUK, HASIL KELUAR

Verifikasi daftar yang lebih besar.

POST /v1/tasks

Kirim hingga 10.000 alamat per tugas. Simpan ID tugas yang dikembalikan dan periksa accepted, skipped dan invalids: tidak semua input pasti masuk antrean. Alamat duplikat, salah format, dan yang disupresi dapat dihapus, dan saldo yang rendah dapat menyebabkan penerimaan sebagian.

curl -X POST https://api.zbounce.net/v1/tasks \
  -H 'Content-Type: application/json' \
  -H "X-API-Key: $ZBOUNCE_API_KEY" \
  -d '{"emails":["hello@example.com","contact@example.org"]}'

Pantau statusnya, lalu ambil setiap halaman hasil. Respons yang hanya berisi input tidak valid dapat memiliki ID tugas kosong; jangan pantau statusnya.

curl "https://api.zbounce.net/v1/tasks/$TASK_ID" \
  -H "X-API-Key: $ZBOUNCE_API_KEY"

curl "https://api.zbounce.net/v1/tasks-results/$TASK_ID?page=1&per_page=100" \
  -H "X-API-Key: $ZBOUNCE_API_KEY"

Hasil tugas yang selesai berformat JSON. Terus ambil halaman hingga seluruh daftar yang diterima telah diperoleh. Untuk pemberitahuan penyelesaian otomatis, sertakan webhook dengan mode: "completed" saat membuat tugas.

{
  "emails": ["hello@example.com"],
  "webhook": {
    "url": "https://your-app.example/hooks/verification",
    "mode": "completed",
    "secret": "YOUR_PRIVATE_WEBHOOK_SECRET"
  }
}

Baca skema konfigurasi webhook dan verifikasi tanda tangan sebelum mengaktifkannya di produksi.

PAHAMI RESPONSNYA

Format bukan berarti alamat ada.

Ini adalah sinyal yang terpisah. Alamat dengan format yang benar tetap bisa tidak ada, sekali pakai, atau tidak mungkin dikonfirmasi.

Kolom	Arti
`valid`	Alamat lolos validasi sintaksis. Ini saja tidak mengonfirmasi kotak suratnya.
`exists`	Hasil pemeriksaan kotak surat. Tafsirkan bersama error dan sinyal catch-all.
`disposable`	Domain dikenali sebagai penyedia email sementara.
`accept_all`	Server menerima alamat apa pun; kotak surat tertentu tidak dapat dikonfirmasi secara andal.
`error_category`	Menjelaskan kegagalan atau risiko, seperti no_mx, risky, atau masalah server sementara.
`permanent_error`	Kegagalan permanen dikembalikan selama pemeriksaan. Kegagalan sementara tidak boleh dianggap sebagai penolakan permanen.
`ttl`	Petunjuk waktu coba ulang/cache dalam detik, jika dikembalikan.

Verifikasi tidak dapat menjamin pengiriman, menghilangkan keluhan, atau membuktikan kepemilikan kotak surat.

Ketahui saldo Anda.

GET /v1/me

curl https://api.zbounce.net/v1/me \
  -H "X-API-Key: $ZBOUNCE_API_KEY"

Respons mencakup kredit tersisa, dicadangkan, dan terpakai, jenis kunci, serta masa berlaku. Satu verifikasi standar menggunakan satu kredit; pemfilteran dan penagihan sebenarnya bergantung pada rute dan penerimaan tugas. Periksa respons sebelum menganggap seluruh daftar yang diunggah telah diproses.

Respons 429 berarti permintaan sedang dibatasi. Tunggu sebelum mencoba lagi. Error lain dapat dikembalikan sebagai JSON atau teks di API saat ini; jangan tafsirkan error HTTP sebagai hasil verifikasi.

Kontrak verifikasi.

Unduh OpenAPI JSON

Kontrak publik mencakup demo, verifikasi cepat, tugas, status tugas, hasil, dan saldo akun. Endpoint pengiriman dan admin berada di luar referensi verifikasi ini.

Butuh bantuan menghubungkan platform Anda? support@zbounce.net