> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.onesignal.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 邮件地址验证
> 在 CSV 导入期间及批量验证邮件地址，以减少退信并保护您的发件人声誉。
邮件地址验证在邮件地址到达您的受众之前检测常见问题。它标记可能增加退信率或损害发件人声誉的拼写错误、无效域名、基于角色的地址和一次性邮件服务。
它在 CSV 导入期间自动运行，也可作为对现有受众进行批量验证的工具。
邮件地址验证根据 OneSignal 的验证标准检查地址。这不是实时退信验证检查，也不保证送达率。
## 验证检查
邮件地址验证针对以下检查评估每个地址：
| 检查 | 检测内容 |
| ----------- | ---------------------------------------- |
| **语法验证** | 缺少必要组件的格式错误地址（例如，缺少 `@`，无效的 TLD） |
| **拼写错误检测** | 常见域名拼写错误，如 `gnail.com` 或 `gmail.con` |
| **MX 记录检查** | 没有有效邮件交换记录的域名；发送到此处的邮件无法送达 |
| **基于角色的地址** | 如 `sales@`、`info@`、`admin@` 等不太可能属于个人的地址 |
| **一次性邮件** | 与临时或一次性邮件服务相关的域名 |
**免费计划**包含语法验证和拼写错误检测。**付费计划**包含以上所有功能，以及 MX 记录检查、基于角色的地址检测和一次性邮件过滤。
如果地址未通过某项检查，邮件地址验证将返回解释具体问题的可读错误。如果地址未通过多项检查，所有失败原因将一起返回，以便您一次性处理所有问题。
***
## 在 CSV 导入期间验证地址
导入 CSV 时，您可以在确认导入之前在**审核**步骤中配置邮件地址验证设置。
前往**受众 > 导入**并上传您的文件。完成**上传**和**映射字段**步骤。如果检测到任何无效邮件地址，**映射字段**步骤将出现警告。
在**审核**步骤中，展开**邮件地址验证设置**。以下选项可用：
* **验证邮件域名（MX 记录）**：确认域名可以接收邮件
* **排除一次性邮件地址**：防止可能降低参与度的临时或一次性地址
* **排除基于角色的邮件地址**：防止通常参与度较低的共享地址，如 `info@` 或 `support@`
默认情况下，三项全部启用。取消选中任何您不想应用于此次导入的选项。
如果您需要导入无效邮件地址（例如，更新抑制或订阅状态），请勾选**允许无效邮件地址**。这将绕过验证并接受任何字符串作为邮件地址。
点击**确认并导入**。导入完成后，您将收到一封总结结果的邮件：
* 已添加的订阅
* 已修改的订阅
* 未导入的行，附有下载被拒绝行的链接
#### 结果
有效地址将添加到您的受众。导入完成后您会收到邮件。验证失败的地址将被排除，可通过结果邮件中的链接下载。
***
## 批量验证现有受众
使用批量验证检查 OneSignal 受众中已有的邮件地址。您将通过邮件以 CSV 导出的形式收到结果。
前往**受众 > 订阅**（或**受众 > 用户**），点击**更新/导入用户**，然后选择**验证邮件地址**。
在弹窗中，点击**开始验证**。邮件地址验证将对您的应用中的所有邮件地址运行。
验证完成后，您将收到来自 OneSignal 的邮件，其中包含**下载 CSV 导出**链接。该链接在 72 小时内有效。邮件总结了失败地址的数量，按以下分类：
* 拼写错误
* 基于角色的地址
* 一次性域名
* 无效 MX 记录
下载 CSV 并审查被标记的地址。
要清理您的受众，请创建包含已更正或已处理地址的新 CSV，并使用以下列格式之一重新导入：
| 目标 | 必需列 | 值 |
| ---------- | -------------------- | --------------------- |
| 重新订阅已更正的地址 | `email`、`subscribed` | `subscribed` = `yes` |
| 取消订阅被标记的地址 | `email`、`subscribed` | `subscribed` = `no` |
| 抑制被标记的地址 | `email`、`suppressed` | `suppressed` = `true` |
#### 结果
您将收到一封包含被标记地址 CSV 导出的邮件，以及按错误类型分类的验证结果摘要。
***
## 验证错误参考
以下错误可能出现在验证结果中：
| 错误 | 含义 | 处理方式 |
| -------------- | --------------------------------------------------------------- | ----------------------- |
| **无效输入** | 地址格式错误，不满足基本语法要求（例如，缺少 `@`，无效的 TLD）。 | 更正或删除该地址。 |
| **邮件地址中有拼写错误** | 在域名中检测到可能的拼写错误。相邻列中会显示建议的更正。 | 应用建议的更正或删除该地址。 |
| **未找到 MX 记录** | 域名没有有效的邮件交换记录。邮件无法送达此地址。 | 删除或抑制该地址。 |
| **基于角色的邮件地址** | 本地部分（`@` 前面）与已知的基于角色的模式匹配，如 `sales@` 或 `support@`。这些地址不太可能属于个人。 | 审查该地址是否适合您的用例，然后抑制或删除它。 |
| **一次性邮件地址** | 域名与临时或一次性邮件服务相关。 | 抑制或删除该地址。 |
***
## API 错误响应
邮件地址验证也适用于通过 API 提交的地址。以下各节描述您可能遇到的错误响应。
API 验证仅检查邮件地址的格式是否正确。它不检查拼写错误、MX 记录、基于角色的地址或一次性域名。这些检查仅在 CSV 导入和批量验证期间可用。
### 发送邮件：创建消息
当您通过[创建消息端点](/reference/create-message)发送到一个或多个无效地址时，无效地址将被排除在投递之外，并在 `invalid_email_tokens` 下返回。
```json theme={null}
{
"id": "",
"errors": {
"invalid_email_tokens": ["invalid@email"]
}
}
```
### 添加用户或订阅：用户模型 API
当您通过[创建用户](/reference/create-user)或[创建订阅](/reference/create-subscription)端点使用无效邮件创建用户或订阅时：
```json theme={null}
{
"errors": [
{
"title": "Invalid `token` format for device type email"
}
]
}
```
### 添加设备：旧版 Players API
当您通过[旧版 Players API](/reference/add-a-device) 使用无效邮件添加或编辑播放器记录时：
```json theme={null}
{
"success": false,
"errors": ["[\"Identifier invalid format.\"]"]
}
```
旧版 Players API 已弃用。请迁移到[用户模型 API](/reference/create-user)，以获取更具描述性的验证错误并访问当前功能。