API Pemeriksaan Keterkiriman Email: Menangani Hasil Terkirim dan Tidak Terkirim

Integrasikan API Pemeriksaan Keterkiriman Email untuk membedakan alamat yang deliverable dan undeliverable dari domain catch-all yang belum ditentukan di seluruh alur kerja sinkron dan massal.

EmailCheckPro menyediakan API pemeriksaan keterkiriman email yang menentukan apakah suatu alamat bersifat deliverable (dapat menerima email) atau undeliverable pada saat pemeriksaan. Status deliverable menunjukkan bahwa alamat tersebut dapat menerima pesan saat diperiksa, sedangkan status undeliverable mengidentifikasi alamat yang tidak dapat menerima email. Layanan ini mengevaluasi alamat di hampir semua domain tanpa mengirimkan pesan ke penerima target. Dengan mengintegrasikan alur kerja API waktu nyata dan massal, tim teknis dapat memisahkan alamat penerima yang aktif dari catatan yang undeliverable dan domain catch-all yang belum ditentukan, sehingga meningkatkan kualitas transmisi sekaligus menjaga kebersihan data di seluruh sistem penyerapan.

Status Keterkiriman Utama dan Lingkup Operasional

Mengevaluasi alamat penerima memerlukan perbedaan yang jelas antara hasil deliverable, undeliverable, dan yang belum ditentukan.

Status deliverable mengonfirmasi bahwa alamat penerima dapat dijangkau dan siap menerima email saat diverifikasi. Sebaliknya, hasil undeliverable menunjukkan bahwa alamat tersebut tidak dapat menerima pesan. Kedua status tersebut mewakili hasil verifikasi yang telah selesai.

Penilaian keterkiriman memberikan sinyal keterjangkauan pada titik waktu tertentu, bukan jaminan permanen. Tim pengembangan menggunakan sinyal ini untuk menghapus alamat yang tidak aktif dari antrean komunikasi, yang membantu melindungi kinerja infrastruktur sekaligus menghormati prinsip minimalisasi data Eropa berdasarkan GDPR Article 5 (Regulation (EU) 2016/679).

Integrasi Sinkron untuk Pemeriksaan Tunggal dan Batch

Aplikasi yang menangkap data kontak saat pendaftaran atau pembaruan profil memerlukan evaluasi sinkron yang cepat. EmailCheckPro menyediakan dua endpoint waktu nyata khusus untuk alur kerja interaktif.

Untuk pengiriman individu, pengembang melakukan kueri POST /api/v1/check dengan satu alamat lengkap.

Saat menangani batch kecil input pengguna, POST /api/v1/batch-check memproses 1 hingga 100 alamat secara sinkron dalam satu permintaan HTTP. Respons multi-cek mempertahankan urutan yang sama dengan daftar input. Setiap catatan menyertakan properti exists beserta detail verifikasi. Dalam skema ini, exists=false menunjukkan bahwa layanan tidak menghasilkan hasil yang lengkap untuk entri tersebut, bukan berarti statusnya undeliverable. Perbedaan ini memungkinkan sistem penyerapan untuk mencoba kembali masalah sementara sambil tetap memfilter entri yang dipastikan undeliverable dengan aman.

Tugas Massal Asinkron untuk Pemrosesan Daftar

Memelihara arsip basis data yang besar memerlukan arsitektur pemrosesan asinkron. Saat mengaudit penyimpanan kontak, sistem mengirimkan pekerjaan verifikasi melalui POST /api/v1/bulk-tasks.

Pengiriman massal menerima file TXT atau CSV terstruktur yang berisi satu alamat email lengkap per baris. Selama pengambilan file, platform secara otomatis menghapus baris duplikat dan entri yang salah format, menyiapkan tugas yang bersih. Batas jumlah yang didokumentasikan berlaku per produk; tim harus meninjau dokumentasi resmi untuk batas tugas saat ini.

Karena pekerjaan massal dijalankan secara asinkron, aplikasi memantau kemajuan menggunakan GET /api/v1/bulk-tasks/{id}. Alur kerja klien harus melakukan polling pada endpoint ini tidak lebih sering dari setiap 30 detik. Setelah pemrosesan selesai, endpoint menyediakan result_url yang menautkan ke file CSV berisi setiap pengenal dan hasil yang diaktifkan. Tautan unduhan yang dihasilkan tetap valid selama 12 jam dan diperbarui setiap kali melakukan kueri status tugas tersebut kembali.

Menangani Catch-All yang Belum Ditentukan dan Pengecualian Format

Pipa kualitas data yang andal harus membedakan antara kegagalan keterkiriman yang eksplisit dan input yang ambigu atau salah format.

Berdasarkan RFC 5322: Internet Message Format, alamat email terdiri dari bagian lokal dan domain yang digabungkan dengan simbol @. Jika entri yang masuk tidak memiliki struktur ini, API memperlakukan payload sebagai format yang tidak valid. Format yang tidak valid tetap berbeda dari status undeliverable, yang mewakili kegagalan sintaksis struktural.

Server email catch-all menyajikan kategori operasional lainnya. Domain ini menerima pesan yang ditujukan ke nama pengguna lokal arbitrer mana pun, yang mencegah mesin verifikasi mengisolasi kotak surat yang valid secara definitif. Daripada menebak, EmailCheckPro menandai konfigurasi catch-all sebagai belum ditentukan. Dalam verifikasi waktu nyata, domain catch-all mengembalikan kode status 42200 tanpa hasil yang lengkap. Pemeriksaan yang belum ditentukan, tidak valid, dan gagal tidak dikenakan biaya, sehingga memungkinkan tim untuk merutekan catatan catch-all ke antrean peninjauan terpisah.

FAQ

Apa yang membedakan status undeliverable dari hasil yang belum ditentukan?

Pemeriksaan waktu nyata untuk domain catch-all mengembalikan kode status 42200 tanpa status yang lengkap, sehingga alamat ini tidak ditagih dan tersedia untuk kebijakan peninjauan terpisah.

Bagaimana perbedaan permintaan API multi-cek dengan tugas massal asinkron?

Panggilan multi-cek menggunakan POST /api/v1/batch-check untuk memvalidasi 1 hingga 100 alamat secara sinkron, mengembalikan hasil langsung dalam respons HTTP sambil mempertahankan urutan input. Tugas massal asinkron menggunakan POST /api/v1/bulk-tasks untuk memproses daftar TXT atau CSV yang besar. Tugas massal berjalan secara offline, memerlukan polling GET /api/v1/bulk-tasks/{id} pada interval 30 detik, dan mengeluarkan CSV yang dapat diunduh melalui result_url yang valid selama 12 jam.

Pelajari Lebih Lanjut

Pilih informasi produk yang sesuai dengan langkah berikutnya dalam alur kerja Anda.

• Lihat dokumentasi produk →
• Hubungi tim kami →