Email Address Ban

Email Address Ban

Email Address Ban 會阻止系統寄送到特定位址，通常原因是硬退信或垃圾郵件投訴。封鎖可保護寄件信譽與送達率。

Schema

interface EmailAddressBan {
  id: string; // "eab_..." - Unique identifier
  account_id: string; // Owning account
  email: string; // Banned email address
  reason: string; // Why address was banned
  banned_until: string | null; // Expiration (null = permanent)
}

屬性

屬性	型別	說明
id	string	帶有 eab_ 前綴的 KSUID
account_id	string	帳戶上下文
email	string	被封鎖的 email 位址
reason	string	封鎖原因
banned_until	string?	到期時間，null 表示永久封鎖

封鎖原因

封鎖原因依 provider 而定，常見值如下：

Reason	說明
hard_bounce	位址不存在
soft_bounce	暫時投遞失敗
complaint	收到垃圾郵件投訴
manual	人工手動封鎖

自動封鎖

範例

{
  "id": "eab_2kHfPZcN9xW4mE8RtY7vB",
  "account_id": "acc_1jGePYbM8wV3lD7QsX6uA",
  "email": "invalid@example.com",
  "reason": "hard_bounce",
  "banned_until": null
}

相關

• Email - 郵件基礎設施
• Email Message Event - 投遞事件