Quando organizzi campagne email o sincronizzi contatti tra la tua app e un ESP, hai bisogno di una regola chiara: chi è autorizzato a ricevere mail e chi deve essere escluso. verify-email.app non sostituisce il link di disiscrizione del tuo ESP o la conformità legale, ma ti offre regole di blacklist e whitelist che appaiono in ogni risposta di verifica come un unico campo: block. Il tuo codice può leggere block prima di inviare, importare una lista o creare un account—senza copiare la logica di autorizzazione/rifiuto in ogni servizio.

• Blacklist — Se l'email o il suo dominio è nella tua blacklist, l'API restituisce block: true. Usa questo per persone che si sono disiscritte, casi di abuso, o domini a cui non vuoi mai inviare mail.

• Whitelist — Quando è attivata la modalità whitelist, solo gli indirizzi (o interi domini) che hai aggiunto alla whitelist ricevono block: false. Tutti gli altri ricevono block: true. Usa questo per liste chiuse—partner, inviti, beta interni—non per una normale newsletter “chiunque può iscriversi”.

• Ordine — La blacklist prevale. Se un indirizzo è nella blacklist, rimane bloccato anche se appare anche nella whitelist.

1. Quando un utente si disiscrive nella tua app o elabori un webhook ESP, prendi il loro indirizzo (o il dominio che blocchi per policy).

2. Aggiungilo con POST /v1/blacklist e un corpo JSON {"value": "[email protected]"} (o "example.com" per bloccare tutti gli indirizzi su quel dominio). Usa l'intestazione X-API-Key con la tua chiave API.

3. Prima di inviare una campagna o inviare una riga al tuo strumento di mailing, verifica l'indirizzo. Se block è true, salta quel destinatario.

Per consentirli nuovamente in seguito (ad esempio, si sono ri-iscritti e hanno confermato), rimuovi la regola con DELETE /v1/[email protected].

1. Attiva la modalità di autenticazione stretta: PUT /v1/whitelist/enabled con un corpo {"enabled": true}.

2. Aggiungi ogni indirizzo o dominio approvato: POST /v1/whitelist con {"value": "[email protected]"} o {"value": "company.com"}.

3. Durante la verifica, block: false significa che l'indirizzo è autorizzato secondo la tua whitelist; gli altri sono bloccati finché non li aggiungi.

Quando non hai bisogno della modalità solo consentito (ad esempio, il ritorno della registrazione pubblica), imposta enabled su false in modo che la whitelist smetta di restringere tutti gli altri.

La maggior parte dei prodotti memorizza il consenso nell'ESP e mantiene lì una lista di soppressione. In verify-email.app solitamente rimuovi l'indirizzo dalla blacklist se si erano disiscritti prima (DELETE sulla blacklist), poi fai affidamento sul tuo ESP per lo stato effettivo dell'iscrizione. Riserva la whitelist per flussi in cui solo le email pre-approvate possono passare.

Puoi gestire le stesse regole nel dashboard oltre che via API—consulta le pagine Blacklist e Whitelist su verify-email.app per il contesto e dettagli API.