Lorsque vous réalisez des campagnes par email ou synchronisez des contacts entre votre application et un ESP, vous avez besoin d'une règle claire : qui est autorisé à recevoir des mails et qui doit être exclu. verify-email.app ne remplace pas le lien de désabonnement de votre ESP ni la conformité légale, mais il vous offre des règles de liste noire et de liste blanche qui apparaissent dans chaque réponse de vérification comme un champ unique : block. Votre code peut lire block avant d'envoyer, d'importer une liste, ou de créer un compte—sans copier la logique d'autorisation/interdiction dans chaque service.

• Liste Noire — Si l'email ou son domaine est sur votre liste noire, l'API retourne block: true. Utilisez cela pour les personnes qui se sont désinscrites, les cas d'abus, ou les domaines auxquels vous ne souhaitez jamais envoyer de mails.

• Liste Blanche — Lorsque le mode liste blanche est activé, seules les adresses (ou les domaines entiers) que vous avez ajoutés à la liste blanche obtiennent block: false. Tout le monde obtient block: true. Utilisez cela pour des listes fermées—partenaires, invitations, bêtas internes—pas pour une newsletter « tout le monde peut s'abonner » normale.

• Ordre — La liste noire l'emporte. Si une adresse est sur la liste noire, elle reste bloquée même si elle apparaît également sur la liste blanche.

1. Lorsqu'un utilisateur se désabonne dans votre application ou que vous traitez un webhook ESP, prenez son adresse (ou le domaine que vous bloquez par politique).

2. Ajoutez cela avec POST /v1/blacklist et un corps JSON {"value": "[email protected]"} (ou "exemple.com" pour bloquer toutes les adresses sur ce domaine). Utilisez l'en-tête X-API-Key avec votre clé API.

3. Avant d'envoyer une campagne ou de pousser une ligne vers votre outil de mailing, vérifiez l'adresse. Si block est true, sautez ce destinataire.

Pour les autoriser à nouveau plus tard (par exemple, ils se sont réabonnés et ont confirmé), supprimez la règle avec DELETE /v1/[email protected].

1. Activez le mode strict d'autorisation uniquement : PUT /v1/whitelist/enabled avec corps {"enabled": true}.

2. Ajoutez chaque adresse approuvée ou domaine : POST /v1/whitelist avec {"value": "[email protected]"} ou {"value": "entreprise.com"}.

3. Lors de la vérification, block: false signifie que l'adresse est autorisée dans votre liste blanche ; d'autres sont bloquées jusqu'à ce que vous les ajoutiez.

Lorsque vous n’avez plus besoin du mode d'autorisation uniquement (par exemple, un retour aux inscriptions publiques), réglez enabled sur false pour que la liste blanche cesse de restreindre tout le monde.

La plupart des produits stockent le consentement dans l'ESP et maintiennent une liste de suppression là-bas. Dans verify-email.app, vous supprimez généralement l'adresse de la liste noire si elle s'était désabonnée auparavant (DELETE sur la liste noire), puis comptez sur votre ESP pour l'état réel de l'abonnement. Réservez la liste blanche pour les flux où seuls les e-mails pré-approuvés peuvent passer.

Vous pouvez gérer les mêmes règles dans le tableau de bord ainsi que via l'API—consultez les pages Liste Noire et Liste Blanche sur verify-email.app pour le contexte et les détails de l'API.