När du driver e-postkampanjer eller synkroniserar kontakter mellan din app och en ESP behöver du en klar regel: vem får ta emot post och vem måste uteslutas. verify-email.app ersätter inte din ESP:s avprenumerationslänk eller juridisk efterlevnad, men det ger dig svarta listor och vita listor regler som visas i varje verifieringssvar som ett enda fält: block. Din kod kan läsa block innan du skickar, importerar en lista eller skapar ett konto—utan att kopiera tillåt/nekande logik till varje tjänst.

• Svartlista — Om e-posten eller dess domän finns på din svartlista returnerar API:et block: true. Använd detta för personer som har valt att avsluta, missbruksfall eller domäner du aldrig vill skicka till.

• Vitlista — När vitlista-läge är på, får endast adresser (eller hela domäner) som du har lagt till på vitlistan block: false. Alla andra får block: true. Använd detta för slutna listor—partners, inbjudningar, interna betatest—inte för ett normalt "vem som helst kan prenumerera" nyhetsbrev.

• Ordning — Svartlista vinner. Om en adress är svartlistad förblir den blockerad även om den också finns på vitlistan.

1. När en användare avprenumererar i din app eller du behandlar en ESP-webhook, ta deras adress (eller den domän du blockerar enligt policy).

2. Lägg till det med POST /v1/svartlist och JSON-kropp {"value": "anvä[email protected]"} (eller "exempel.com" för att blockera alla adresser på den domänen). Använd headern X-API-Key med din API-nyckel.

3. Innan du skickar en kampanj eller pushar en rad till ditt e-postverktyg, verifiera adressen. Om block är true, hoppa över den mottagaren.

För att tillåta dem igen senare (t.ex. om de prenumererar igen och bekräftar), ta bort regeln med DELETE /v1/svartlist?value=anvä[email protected].

1. Slå på strikt tillåt-endast-läge: PUT /v1/vitlist/enabled med kropp {"enabled": true}.

2. Lägg till varje godkänd adress eller domän: POST /v1/vitlist med {"value": "användare@företag.com"} eller {"value": "företag.com"}.

3. Vid verifiering, block: false betyder att adressen är tillåten under din vitlista; andra blockeras tills du lägger till dem.

När du inte behöver tillåt-endast-läge (t.ex. när offentlig anmälan återvänder), ställ in enabled tillbaka till false så att vitlistan slutar begränsa alla andra.

De flesta produkter lagrar samtycke i ESP och upprätthåller en undertryckningslista där. I verify-email.app tar du vanligen bort adressen från svartlistan om de tidigare hade avprenumererat (DELETE på svartlistan), sedan förlitar du dig på din ESP för den faktiska prenumerationsstatusen. Reservera vitlistan för flöden där endast förgodkända e-postmeddelanden kan passera.

Du kan hantera samma regler i instrumentpanelen såväl som via API—se sidorna Svartlistan och Vitlistan på verify-email.app för sammanhang och API-detaljer.