Ketika Anda menjalankan kampanye email atau sinkronisasi kontak antara aplikasi Anda dan ESP, Anda membutuhkan satu aturan jelas: siapa yang diizinkan menerima email dan siapa yang harus dikecualikan. verify-email.app tidak menggantikan tautan berhenti langganan ESP Anda atau kepatuhan hukum, tetapi memberikan Anda aturan daftar hitam dan daftar putih yang muncul di setiap respons verifikasi sebagai satu bidang: block. Kode Anda dapat membaca block sebelum mengirim, mengimpor daftar, atau membuat akun—tanpa menyalin logika izinkan/tolak ke setiap layanan.

• Daftar Hitam — Jika email atau domainnya ada di daftar hitam Anda, API akan mengembalikan block: true. Gunakan ini untuk orang-orang yang memilih keluar, kasus penyalahgunaan, atau domain yang tidak pernah ingin Anda kirimi email.

• Daftar Putih — Ketika mode daftar putih diaktifkan, hanya alamat (atau seluruh domain) yang Anda tambahkan ke daftar putih yang mendapatkan block: false. Yang lain mendapatkan block: true. Gunakan ini untuk daftar tertutup—mitra, undangan, beta internal—bukan untuk newsletter "siapa saja bisa berlangganan" biasa.

• Urutan — Daftar hitam mengatasi. Jika sebuah alamat diblokir dalam daftar hitam, ia tetap diblokir meskipun juga muncul dalam daftar putih.

1. Ketika pengguna berhenti langganan di aplikasi Anda atau Anda memproses webhook ESP, ambil alamat mereka (atau domain yang Anda blokir berdasarkan kebijakan).

2. Tambahkan dengan POST /v1/blacklist dan JSON body {"value": "[email protected]"} (atau "example.com" untuk memblokir semua alamat di domain tersebut). Gunakan header X-API-Key dengan API key Anda.

3. Sebelum Anda mengirim kampanye atau memuat baris ke alat kirim email, verifikasi alamatnya. Jika block adalah true, lewati penerima tersebut.

Untuk mengizinkan mereka lagi nanti (misalnya mereka berlangganan ulang dan mengonfirmasi), hapus aturan dengan DELETE /v1/[email protected].

1. Nyalakan mode izinkan ketat: PUT /v1/whitelist/enabled dengan body {"enabled": true}.

2. Tambahkan setiap alamat atau domain yang disetujui: POST /v1/whitelist dengan {"value": "[email protected]"} atau {"value": "company.com"}.

3. Saat memverifikasi, block: false berarti alamat diizinkan di bawah daftar putih Anda; yang lain diblokir hingga Anda menambahkannya.

Ketika Anda tidak lagi memerlukan mode izinkan saja (misalnya pendaftaran publik kembali), set enabled kembali ke false sehingga daftar putih berhenti membatasi yang lain.

Kebanyakan produk menyimpan persetujuan di ESP dan mempertahankan daftar penindasan di sana. Di verify-email.app, Anda biasanya menghapus alamat dari daftar hitam jika mereka berhenti langganan sebelumnya (DELETE pada daftar hitam), lalu mengandalkan ESP Anda untuk status berlangganan sebenarnya. Simpan daftar putih untuk alur di mana hanya email yang telah diizinkan sebelumnya yang dapat lolos.

Anda dapat mengelola aturan yang sama di dashboard serta melalui API—lihat halaman Daftar Hitam dan Daftar Putih di verify-email.app untuk konteks dan detail API.