メールキャンペーンを実施する際やアプリとESPの間でコンタクトを同期する際には、明確なルールが必要です：誰がメールを受け取ることが許可されているか、誰が除外されるべきか。verify-email.appはESPの購読解除リンクや法令遵守に取って代わるものではありませんが、全ての検証応答に単一のフィールドとして表示されるブラックリストとホワイトリストのルールを提供します：block。コードは、許可/拒否のロジックを各サービスにコピーすることなく、送信前、リストのインポート、またはアカウントの作成の際にblockを読み取ることができます。

• ブラックリスト — メールやそのドメインがブラックリストにある場合、APIはblock: trueを返します。オプトアウトした人、悪用ケース、送信したくないドメインに利用します。

• ホワイトリスト — ホワイトリストモードがオンの場合、ホワイトリストに追加したアドレス（またはドメイン）がblock: falseを取得します。その他全員はblock: trueを取得します。クローズドリスト—パートナー、招待、内部ベータ用に使用し、一般の「誰でも購読可」のニュースレターには使用しません。

• 順序 — ブラックリストが優先されます。アドレスがブラックリストにある場合、ホワイトリストにあってもブロックされたままです。

1. ユーザーがアプリで購読を解除する際、またはESPのWebhookを処理する際、そのアドレス（またはポリシーでブロックするドメイン）を取得します。

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に依存します。事前承認されたメールのみ通過させるフローには、ホワイトリストを予約してください。

APIと同様に、ダッシュボードで同じルールを管理できます。コンテキストやAPIの詳細については、verify-email.appのブラックリストとホワイトリストのページを参照してください。