Когда вы запускаете email-кампании или синхронизируете контакты между вашим приложением и ESP, вам нужно одно четкое правило: кто может получать письма, а кто должен быть исключен. verify-email.app не заменяет ссылку на отписку вашего ESP или юридические требования, но предоставляет вам правила черного списка и белого списка, которые отображаются в каждом ответе проверки как одно поле: block. Ваш код может читать block перед отправкой, импортом списка или созданием аккаунта — без копирования логики разрешений/запретов в каждый сервис.

• Черный список — Если email или его домен находится в вашем черном списке, API возвращает block: true. Используйте это для людей, отказавшихся от подписки, в случаях злоупотреблений или для доменов, на которые вы никогда не хотите отправлять почту.

• Белый список — Когда включен режим белого списка, только адреса (или целые домены), добавленные вами в белый список, получают block: false. Все остальные получают block: true. Используйте это для закрытых списков — партнеров, приглашений, внутренних бета-тестирований — не для обычной рассылки, на которую "каждый может подписаться".

• Порядок — Черный список доминирует. Если адрес в черном списке, он остается заблокированным, даже если также указан в белом списке.

1. Когда пользователь отписывается в вашем приложении или вы обрабатываете вебхук ESP, возьмите его адрес (или домен, который вы блокируете по политике).

2. Добавьте его с помощью POST /v1/blacklist и JSON тела {"value": "[email protected]"} (или "example.com" чтобы заблокировать все адреса на этом домене). Используйте заголовок X-API-Key с вашим API-ключом.

3. Перед отправкой кампании или добавлением записи в ваш почтовый инструмент проверьте адрес. Если block равно true, пропустите этого получателя.

Чтобы снова разрешить их позже (например, они снова подписались и подтвердили), удалите правило с помощью DELETE /v1/[email protected].

1. Включите строгий режим только для разрешений: PUT /v1/whitelist/enabled с телом {"enabled": true}.

2. Добавьте каждый одобренный адрес или домен: POST /v1/whitelist с {"value": "[email protected]"} или {"value": "company.com"}.

3. При проверке block: false означает, что адрес разрешен по вашему белому списку; остальные блокируются, пока вы их не добавите.

Когда вам не нужен режим только разрешений (например, возвращается публичная регистрация), установите enabled обратно в false, чтобы белый список перестал ограничивать всех остальных.

Большинство продуктов хранят согласие в ESP и поддерживают список подавлений там. В verify-email.app вы обычно удаляете адрес из черного списка, если они отписались ранее (DELETE на черном списке), затем полагаетесь на ваш ESP для фактического состояния подписки. Оставьте белый список для потоков, где могут пройти только предварительно одобренные email.

Вы можете управлять теми же правилами в панели управления, а также через API – см. страницы Черный список и Белый список на verify-email.app для контекста и деталей API.