邮箱封禁

邮箱封禁

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	被阻止的邮箱地址
reason	string	封禁原因
banned_until	string?	到期时间；null 表示永久封禁

封禁原因

原因由服务商定义，常见值包括：

原因	说明
hard_bounce	地址不存在
soft_bounce	临时投递失败
complaint	收到垃圾邮件投诉
manual	手动封禁

自动封禁

示例

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

相关

• 邮件 - 邮件基础设施
• Email Message Event - 投递事件