Langkau ke kandungan utama
🎬 Memperkenalkan tutorial video BillionVerify: panduan ringkas tentang pengesahan email, alat percuma dan pembersihan prospek.Tonton video

API Validasi Email

Satu endpoint untuk setiap jenis pengesahan. API validasi email masa nyata dengan semakan SMTP, respons JSON berstruktur serta integrasi native MCP dan Agent Skills.

Konsol API validasi email dengan permintaan POST, kad Kunci API, lencana 200 OK dan respons JSON

Lihat cara ia berfungsi

Cara menggunakan API pengesahan email dalam borang pendaftaran

Cara menggunakan API pengesahan email dalam borang pendaftaran: semak alamat dalam satu panggilan, sebelum anda menyimpannya. Cabangkan mengikut status, log reason, dan layan unknown sebagai cuba semula, bukan penolakan.

API Pengesahan Email

Sahkan secara Masa Nyata

Gunakan panggilan API mudah untuk mengesahkan alamat semasa pendaftaran, pengayaan, aliran kerja ejen AI, atau saluran paip pemprosesan senarai tersuai.

JSON berstrukturRespons masa nyataPengesahan SMTP
Mulakan percuma
API Validasi Email Masa Nyata memulangkan respons 200 OK selepas semakan SMTP

Setiap mod API validasi, satu endpoint

Setiap jenis pengesahan boleh diakses melalui API validasi email REST yang sama.

Kad mod API semakan kesahan email percuma untuk integrasi Tunggal, Kelompok, Fail dan SDK

Pengesahan Email Tunggal

POST /verify — satu panggilan API validasi email masa nyata yang memberikan respons secara langsung. Mengembalikan status, kebolehhantaran, skor kualiti dan penanda risiko dalam satu objek JSON.

Pengesahan Kelompok

POST /verify/bulk — sahkan sehingga 50 alamat secara segerak bagi setiap panggilan API. Semua hasil dikembalikan dalam satu respons API, menggunakan skema yang sama seperti validasi tunggal.

Pemprosesan Fail Tak Segerak

POST /verify/file — serahkan fail CSV atau Excel kepada API untuk pemprosesan latar belakang. Hasil dihantar melalui panggilan balik webhook apabila kerja API selesai.

SDK Rasmi

Pustaka klien type-safe untuk API validasi email percuma dalam Python, Node.js, Go dan PHP. Cuba semula secara automatik apabila gagal, pengendalian ralat penuh dan jenis respons yang sama dalam semua bahasa.

Sokongan webhook dalam API validasi

Terima hasil API secara tak segerak dan buat pertanyaan terhadap sejarah mesej.

Webhook API validasi email menghantar Peristiwa Panggilan balik dengan lencana Cuba semula

Penghantaran Tak Segerak

Cipta Webhook

Daftarkan endpoint HTTP untuk menerima hasil API sebaik sahaja kerja atau kelompok selesai. API menyokong payload tersuai, percubaan semula automatik apabila gagal dan konfigurasi per kerja atau global.

  • Acara selesai kerja dengan ringkasan keputusan
  • Percubaan semula automatik pada penghantaran gagal
  • Konfigurasi per-kerja atau peringkat akaun

Sejarah Mesej

Soal Selidik Mesej

Akses log acara webhook penuh untuk mendapatkan hasil API terdahulu, menyahpepijat kegagalan penghantaran atau memainkan semula pemberitahuan yang terlepas. Acara API disimpan selama 30 hari.

  • Soal selidik acara mengikut ID kerja atau julat tarikh
  • Putar semula penghantaran yang terlepas atau gagal
  • Pengekalan acara 30 hari

Kontrak respons

Hasil API validasi email, medan demi medan

Kebanyakan pasukan menggunakan API validasi untuk menggantikan ungkapan biasa. Peningkatan ini hanya berbaloi jika respons API membawa lebih banyak maklumat daripada nilai boolean yang digantikannya.

status ialah medan yang harus menentukan cabang kod anda

API mengembalikan satu daripada empat status: boleh dihantar, tidak boleh dihantar, berisiko atau tidak diketahui. Empat keadaan ini wujud kerana realiti mempunyai empat keadaan, dan mana-mana API validasi yang memampatkannya menjadi benar atau palsu memaksa setiap pemanggil mencipta semula nuansa yang hilang.

Buat cabang berdasarkan status dahulu. Semua yang lain dalam respons API validasi email percuma menerangkan status itu, bukan menggantikannya.

skor dan tahap risiko adalah untuk pemeringkatan, bukan tapisan

Skor kualiti antara 0 hingga 100 dan tahap risiko membolehkan anda menyusun baris gilir, mengutamakan susulan jualan atau melaraskan ambang bagi setiap saluran. Kedua-duanya ialah medan terbitan API, jadi anggapnya sebagai panduan susunan, bukan keputusan muktamad API.

Menggunakan skor sahaja sebagai syarat kelulusan boleh menyebabkan pasukan menolak pelanggan yang baik tanpa sengaja. Gunakan status sebagai syarat; gunakan skor untuk pemeringkatan.

kod sebab menjadikan API boleh dinyahpepijat

Setiap jawapan API yang tidak boleh dihantar mengandungi sebab yang boleh dibaca mesin. Sintaks tidak sah, tiada laluan mel, peti mel ditolak dan penangguhan oleh penyedia ialah masalah berbeza dengan penyelesaian berbeza, dan API validasi email percuma kami menamakan setiap satunya dan bukannya mengembalikan kegagalan umum.

Log kod sebab API, bukan penerangan biasa. Kod itu kekal stabil merentas keluaran dan membolehkan tiket sokongan tentang satu alamat dijawab beberapa bulan kemudian.

bendera boolean menerangkan alamat, bukan kebolehhantarannya

Pakai buang, akaun peranan, catch-all dan webmail peribadi percuma diterima sebagai bendera API yang berasingan. Sesuatu alamat boleh dihantar dengan sempurna dan masih mempunyai ketiga-tiganya, tepat seperti keadaan yang tidak dapat dinyatakan oleh validator sintaks tetapi boleh dinyatakan oleh API.

Inilah perbezaan praktikal antara API validasi email masa nyata dengan semakan format: semakan format memberitahu anda bahawa rentetan itu tersusun dengan betul, manakala API memberitahu anda sifat sebenar alamat tersebut.

Migrasi

Beralih daripada validator sintaks kepada API validasi sebenar

Pasukan biasanya tiba di sini dengan regex atau panggilan pustaka yang sudah ada dalam pangkalan kod. Migrasi API itu kecil, tetapi tiga tabiat perlu berubah bersamanya.

Berhenti menganggap format sebagai jawapan

Ungkapan biasa membuktikan bahawa sesuatu rentetan boleh menjadi alamat. API validasi email percuma ini membuktikan bahawa pelayan mel menerimanya pada masa ini. Kekalkan regex sebagai petunjuk murah di sisi klien jika mahu, tetapi jangan lagi biarkannya menentukan sama ada rekod itu baik.

Dalam amalan, ini bermaksud membuang cabang yang menyimpan rekod hanya kerana formatnya sah, lalu menggantikannya dengan cabang berdasarkan medan status API.

Tetapkan had masa dan laluan sandaran untuk API

Panggilan rangkaian boleh menjadi perlahan apabila penyedia penerima lambat. Tetapkan had masa API yang sesuai untuk borang anda dan tentukan lebih awal apa yang berlaku apabila tempoh itu tamat: biasanya terima alamat tersebut, tandakannya sebagai belum disahkan dan semak semula melalui panggilan API kemudian.

API validasi email masa nyata tidak sepatutnya menjadi punca pendaftaran gagal. Turunkan status kepada belum disahkan, bukan ditolak.

Simpan hasil sebagai data, bukan sebagai penapis

Simpan status API, kod sebab, bendera dan cap masa semakan pada rekod. Pasukan yang hanya menyimpan boolean yang telah dibersihkan tidak dapat menjelaskan keputusan penindasan selepas tiga kempen, atau membezakan bukti API baharu daripada bukti lapuk.

Menyimpan respons API penuh juga membolehkan anda mengubah polisi tanpa mengesahkan semula: fakta kekal, hanya peraturan yang membacanya berubah.

Kendalikan status tidak diketahui secara sengaja, sekali sahaja

Status tidak diketahui bukan ralat API dan bukan kegagalan. Ia bermaksud penyedia penerima tidak memberikan kepastian. Tentukan polisi percubaan semula di satu tempat — baris gilir, tempoh tunda, bilangan maksimum percubaan API — dan bukannya menyelerakkan percubaan semula ad hoc di seluruh pangkalan kod.

Kebanyakan hasil tidak diketahui diselesaikan melalui panggilan API kemudian, sebab itulah API validasi email percuma kami melaporkannya dengan jujur dan tidak meneka.

Saluran integrasi

Empat cara memanggil API validasi email

Satu endpoint, empat bentuk API. Pilih berdasarkan saiz dan kependaman kerja, bukan keutamaan peribadi.

  1. 1

    Satu alamat, secara segerak

    POST /verify menerima satu alamat dan mengembalikan JSON penuh dalam satu hingga tiga saat. Inilah laluan API validasi email masa nyata yang digunakan oleh borang pendaftaran, pembayaran dan suntingan profil.

    Oleh sebab ia hanya satu panggilan API tanpa kitar hayat kerja, ini juga saluran paling mudah untuk diuji sebelum anda membina sesuatu yang lebih besar.

  2. 2

    Sehingga 50 alamat dalam satu panggilan

    POST /verify/bulk mengesahkan sehingga 50 alamat secara segerak dan mengembalikannya dengan skema yang sama. Gunakannya apabila halaman atau kerja secara semula jadi mengendalikan beberapa rekod pada satu-satu masa.

    Had kelompok ialah sempadan tegas API, bukan sempadan longgar. Payload yang lebih besar ditolak dengan ralat API yang jelas dan menghala ke endpoint fail, supaya tiada apa-apa yang berubah secara senyap menjadi permintaan perlahan.

  3. 3

    Fail, secara tak segerak

    POST /verify/file menerima CSV atau Excel, memprosesnya di latar belakang dan memanggil webhook anda apabila kerja API selesai. Tiada sambungan yang perlu dibiarkan terbuka ketika fail besar diproses.

    Untuk beban kerja berbentuk senarai dan bukannya berbentuk API, Pengesahan Email Pukal menjalankan enjin yang sama pada fail yang dimuat naik, dengan penyahduplikasian dan eksport CSV.

  4. 4

    Daripada ejen AI dan klien MCP

    MCP Server menyediakan API validasi email yang sama kepada Claude Desktop dan Cursor dalam bahasa semula jadi, manakala Agent Skills memasangnya pada platform ejen dengan satu klik. Kedua-duanya mengembalikan JSON berstruktur yang sama seperti REST API.

    Ini memastikan tingkah laku ejen kekal jujur: alat tidak boleh merumuskan status tidak diketahui sebagai baik kerana respons API validasi email percuma itulah yang dibaca oleh ejen.

Skop

Perkara yang sengaja diserahkan oleh API validasi kepada anda

Skop API ini sengaja dikecilkan. Setiap perkara di bawah ialah keperluan sebenar — ia cuma berada di tempat lain dalam sistem anda, bukan dalam API validasi.

Persetujuan dan penindasan

API validasi email percuma kami boleh memberitahu anda bahawa sesuatu alamat menerima mel. Ia tidak dapat memberitahu sama ada individu itu bersetuju menerima mesej daripada anda dan tidak membaca senarai penindasan anda.

Simpan persetujuan dalam sistem rekod anda sendiri dan semaknya sebelum, bukan selepas, panggilan API.

Identiti dan pekerjaan

Alamat syarikat yang boleh dihantar tidak membuktikan bahawa individu bernama itu mengawalnya atau masih bekerja di sana. Alias, peti masuk dikongsi dan data pengayaan lapuk kerap mematahkan andaian tersebut.

Gunakan data pihak pertama untuk identiti. API validasi email percuma ini mengembalikan bukti tentang peti mel, bukan tentang manusia.

Penempatan peti masuk

Penerimaan SMTP ialah fakta di sisi penerima. Sama ada mesej anda sampai ke peti masuk bergantung pada reputasi penghantar, autentikasi, kandungan dan sejarah aduan, yang semuanya tidak dapat diperhatikan oleh API.

Baiki kualiti alamat dengan API; baiki penempatan melalui kerja di sisi penghantar dan pemantauan yang tidak dapat dilakukan oleh API untuk anda.

Kesegaran

Setiap respons API menerangkan keadaan pada saat panggilan dibuat. Peti mel ditutup, alias dihentikan dan domain berpindah, maka hasil API yang disimpan menjadi lapuk sama ada dibaca semula ataupun tidak.

Sahkan semula mengikut jadual yang sepadan dengan kadar perubahan data anda dan biarkan cap masa semakan menentukan keputusan itu secara automatik.

Saluran berkaitan

Kedudukan API validasi email bersama alat lain

Enjin yang sama digunakan di sebalik beberapa saluran API. Pilihan anda bergantung pada pihak yang membuat permintaan dan bilangan alamat yang terlibat.

Sudut pengesahan bagi endpoint yang sama

API Pengesahan Email mendokumentasikan endpoint yang sama untuk pasukan yang mencari pengesahan dan bukannya validasi, dengan bukti SMTP diterangkan secara lebih mendalam.

Skema, kredit dan ketepatannya sama — hanya pembingkaian dokumentasi yang berbeza.

Alat pelayar untuk satu alamat

Apabila seseorang perlu melihat satu hasil dan bukannya mengautomasikan sesuatu, Pengesah Email menjalankan saluran pemprosesan yang sama dalam pelayar dan menunjukkan setiap bendera yang akan dikembalikan oleh API.

Ini cara terpantas untuk mengesahkan tingkah laku enjin sebelum menulis kod yang menggunakan API validasi email percuma.

Validasi cetek tanpa SMTP

Jika keperluannya benar-benar hanya format dan penghalaan mel, Validator Email berhenti pada sintaks dan MX tanpa menggunakan semakan SMTP.

Gunakannya untuk saringan awal yang murah dan simpan API validasi email masa nyata bagi rekod yang lantunannya benar-benar membawa kos.

Soalan Lazim

1. Seberapa pantas API validasi email?

Validasi tunggal ialah panggilan masa nyata: hasil bagi alamat yang pernah disemak diambil daripada cache, manakala semakan SMTP penuh menunggu respons pelayan mel penerima, jadi tempohnya berbeza mengikut penyedia. Inilah yang membolehkannya digunakan sebagai API validasi email masa nyata dalam borang, selagi borang tidak tersekat kerana menunggu respons yang lambat. API menyokong sehingga 6,000 permintaan tunggal seminit dan 1,500 permintaan kelompok seminit.

2. Bagaimanakah saya mengintegrasikan API validasi email?

API validasi menggunakan panggilan REST standard dengan respons JSON. SDK rasmi tersedia untuk Python, Node.js, Go dan PHP. Kebanyakan integrasi API selesai dalam masa kurang 30 minit. MCP Server dan Agent Skills langsung tidak memerlukan kod — pasang sekali dan API validasi email percuma berfungsi dalam mana-mana klien AI yang disokong.

3. Berapakah kos API validasi email?

Pelan Starter berharga $20 untuk 20,000 kredit pada kadar $0.001 setiap email — tiada yuran bulanan, anda hanya membayar apa yang digunakan. Harga volum turun sehingga $0.00035 setiap email bagi 1M kredit. Peringkat API validasi email percuma menyediakan 20 kredit percuma setiap hari anda log masuk, sehingga 600 sebulan, tanpa memerlukan kad kredit.

4. Apakah yang disertakan dalam setiap respons API validasi?

Setiap respons API merangkumi status validasi (boleh dihantar, tidak boleh dihantar, berisiko atau tidak diketahui), skor kualiti antara 0–100, tahap risiko dan kod sebab. Bendera email pakai buang, bendera akaun peranan, pengesanan catch-all dan cadangan pembetulan kesilapan taip turut disertakan.

5. Adakah API validasi ini selamat?

Semua permintaan API menggunakan HTTPS. Pengesahan kunci API diperlukan bagi setiap panggilan API dan senarai putih IP tersedia untuk keselamatan tambahan. BillionVerify mematuhi sepenuhnya GDPR dan CCPA dengan pemadaman data automatik selepas pemprosesan.

6. Bagaimanakah ejen AI dan LLM menggunakan API validasi ini?

Ejen AI bersambung melalui MCP Server (bahasa semula jadi dalam Claude dan Cursor), Agent Skills siap bina (pemasangan satu klik untuk Claude dan Manus), atau panggilan REST terus daripada LangChain, CrewAI, atau mana-mana SDK Anthropic atau OpenAI. Setiap kaedah menggunakan API validasi email yang sama dan mengembalikan JSON berstruktur yang sama — tanpa perlu transformasi respons.

7. Apakah perbezaan antara API validasi email dan API pengesahan email?

API validasi email dan API pengesahan email biasanya merujuk kepada endpoint yang sama — endpoint yang menyemak sama ada alamat itu benar dan boleh dihantar. BillionVerify menjalankan semakan peringkat SMTP yang mengesahkan peti mel wujud pada pelayan penerima, bukan sekadar validasi DNS atau sintaks. Endpoint tunggal /verify mengembalikan status, skor kualiti, bendera pakai buang, bendera akaun peranan dan pengesanan catch-all dalam satu respons JSON.

API Pengesahan Email

Dapatkan kunci API anda

Satu endpoint untuk setiap jenis validasi. MCP Server dan Agent Skills disertakan. Peringkat API validasi email percuma memberi anda 20 kredit setiap hari anda log masuk, sehingga 600 sebulan, tanpa memerlukan kad kredit.

600 kredit percuma sebulan · Integrasi native MCP Server · Tanpa kad kredit

0
Kredit untuk hasil tidak diketahui
Masa nyata
Kelajuan API
$0.00014
Setiap email
600/bln
Percuma selama-lamanya