Kiedy prowadzisz kampanie e-mailowe lub synchronizujesz kontakty między swoją aplikacją a ESP, potrzebujesz jednej jasnej zasady: kto ma prawo otrzymywać maile, a kto musi być wykluczony. verify-email.app nie zastępuje linku do wypisania się z ESP ani zgodności prawnej, ale daje czarną listę i białą listę zasad, które pojawiają się w każdej odpowiedzi weryfikacyjnej jako jedno pole: block. Twój kod może odczytywać block przed wysłaniem, importowaniem listy lub tworzeniem konta – bez konieczności kopiowania logiki dopuszczania/odrzucania do każdej usługi.

• Czarna lista — Jeśli e-mail lub jego domena znajduje się na Twojej czarnej liście, API zwraca block: true. Używaj tego dla osób, które zrezygnowały, w przypadkach nadużyć lub domen, do których nigdy nie chcesz wysyłać maili.

• Biała lista — Gdy tryb białej listy jest włączony, tylko adresy (lub całe domeny), które dodałeś do białej listy, otrzymują block: false. Wszyscy inni otrzymują block: true. Używaj tego dla zamkniętych list — partnerów, zaproszeń, wewnętrznych beta-testów — a nie dla normalnego newslettera, do którego każdy może się zapisać.

• Kolejność — Czarna lista ma pierwszeństwo. Jeśli adres jest na czarnej liście, pozostaje zablokowany, nawet jeśli pojawia się także na białej liście.

1. Kiedy użytkownik wypisuje się w Twojej aplikacji lub przetwarzasz webhook ESP, weź jego adres (lub domenę, którą blokujesz zgodnie z polityką).

2. Dodaj go za pomocą POST /v1/blacklist i ciała JSON {"value": "[email protected]"} (lub "example.com", aby zablokować wszystkie adresy na tej domenie). Użyj nagłówka X-API-Key z kluczem API.

3. Zanim wyślesz kampanię lub dodasz wiersz do narzędzia mailingowego, zweryfikuj adres. Jeśli block jest true, pomiń tego odbiorcę.

Aby ponownie umożliwić im subskrypcję później (np. zapisali się ponownie i potwierdzili), usuń regułę za pomocą DELETE /v1/[email protected].

1. Włącz ścisły tryb tylko dozwolonych: PUT /v1/whitelist/enabled z ciałem {"enabled": true}.

2. Dodaj każdy zatwierdzony adres lub domenę: POST /v1/whitelist z {"value": "[email protected]"} lub {"value": "company.com"}.

3. Podczas weryfikacji, block: false oznacza, że adres jest dozwolony w ramach białej listy; inni są zablokowani, dopóki ich nie dodasz.

Kiedy nie potrzebujesz trybu tylko dozwolonych (np. powrót do publicznego zapisania), ustaw enabled z powrotem na false, aby biała lista przestała ograniczać innych.

Większość produktów przechowuje zgodę w ESP i utrzymuje tam listę tłumienia. W verify-email.app zazwyczaj usuń adres z czarnej listy, jeśli wcześniej się wypisali (DELETE na czarnej liście), następnie polegaj na swoim ESP w rzeczywistym stanie subskrypcji. Zachowaj biała lista dla ścieżek, gdzie tylko wcześniej zatwierdzone e-maile mogą przejść.

Możesz zarządzać tymi samymi zasadami w panelu jak i za pomocą API—zobacz strony Czarna lista i Biała lista na verify-email.app dla kontekstu i szczegółów API.