使用黑名单和白名单管理新闻通讯订阅和退订
当您运行电子邮件营销活动或在应用程序和ESP之间同步联系人时，您需要一个明确的规则：谁可以接收邮件，谁必须被排除。verify-email.app 不替代您的ESP的退订链接或法律合规性，但它为您提供出现在每次验证响应中的黑名单和白名单规则，作为单个字段：block。您的代码可以在发送、导入列表或创建帐户之前读取block，无需将允许/拒绝逻辑复制到每个服务中。
列表的作用
黑名单 — 如果电子邮件或其域名在您的黑名单上，API 会返回
block: true。用于选择不接收邮件的人、滥用情况或您永远不想发邮件的域名。白名单 — 当白名单模式开启时，只有您添加到白名单的地址（或整个域）会得到
block: false。其他人都会得到block: true。用于封闭列表——合作伙伴、邀请函、内部测试，而不是普通的“任何人都可以订阅”新闻通讯。优先级 — 黑名单优先。如果地址在黑名单上，即使它也出现在白名单上，它仍然会被阻止。
重要：使用block来做出“我们是否应该发送/同步此联系人的决定”。valid本身并不包含您的退订或封闭列表政策。
从您的活动中退订（黑名单）
当用户在您的应用程序中退订或您处理一个ESP webhook时，获取他们的地址（或您根据策略阻止的域）。
使用
POST /v1/blacklist和JSON体{"value": "[email protected]"}（或"example.com"以阻止该域上的所有地址）添加它。使用头X-API-Key和您的API密钥。在您发送活动或向您的邮件工具推送数据行之前，验证地址。如果
block为真，则跳过该收件人。
如果稍后需要重新允许他们（例如，他们重新订阅并确认），通过DELETE /v1/[email protected]删除该规则。
在封闭或仅限邀请的列表中订阅（白名单）
开启严格允许模式：
PUT /v1/whitelist/enabled，请求体{"enabled": true}。添加每个核准的地址或域：
POST /v1/whitelist，请求体{"value": "[email protected]"}或{"value": "company.com"}。在验证时，
block: false表示根据您的白名单地址被允许；直到您添加其他人为止，他们会被阻止。
当您不再需要允许模式时（例如，公共注册返回），将enabled设置回false，这样白名单就不再限制其他人。
典型“新闻通讯订阅”没有封闭列表
大多数产品在ESP中存储同意并在那保持一个抑制列表。在verify-email.app中，如果他们之前已退订，通常从黑名单中移除地址（DELETE在黑名单上），然后依靠您的ESP来处理实际的订阅状态。保留白名单用于仅预先批准的电子邮件可以通过的流程。
仪表板
您可以在仪表板中以及通过API管理相同的规则——请查看verify-email.app上的黑名单和白名单页面以获取上下文和API详细信息。
常见问题
黑名单的目的是什么？
黑名单确保在此列表上的电子邮件或域不会接收任何通信。用于选择不接收邮件的人、滥用情况或您永远不想发邮件的域名。
白名单如何工作？
白名单在严格允许模式下激活，仅允许与添加到白名单的地址或域进行通信。其他人将被阻止，直到他们被添加。
如果地址同时在黑名单和白名单上会发生什么？
黑名单优先。如果地址在黑名单上，即使它出现在白名单上，它也会被阻止。