产品指南
如何对准备好的列表执行批量邮箱可达性检测
准备 TXT 或 CSV 列表，启动异步批量任务，轮询任务状态，并将结果文件分类为可投递、不可投递和无法判定。
使用 EmailCheckPro 进行批量邮箱验证的分步工作流程：准备文件、启动任务、轮询状态并处理结果文件。
使用 EmailCheckPro 进行批量邮箱验证是一项异步任务。准备一个纯文本 TXT 或 CSV 文件，每行包含一个完整的地址，将其作为批量任务提交，轮询任务直至完成，然后下载一份 CSV 结果文件。每个地址都会被报告为可投递（在检测时可以接收邮件）或不可投递。无法完成检测的地址（例如 Catch-All 域名）将保持为无法判定状态，需单独处理。该检测不会向列表中的任何地址发送任何内容。
在批量邮箱验证前准备列表
大多数失败或低效的运行源于文件本身，而非检测过程。在提交之前，请完成以下核对清单：
- 仅使用 TXT 或 CSV 格式。 每行一个完整地址，包含本地部分、@ 符号和域名。不支持 XLSX 等电子表格格式，请先导出为 CSV。
- 去除空格和明显的拼写错误。 多余的空格或缺失的域名会导致该行无法使用。
- 尽可能去重。 虽然无效和重复的行会在准备过程中被移除，但自行清理可以确保数量符合预期。
- 每个文件仅限一种产品。 可达性检测文件和头像检测文件是不同的任务。邮箱头像检测仅接受 Gmail、Yandex 和 Mail.ru 地址，因此混合列表应归入可达性检测任务。
- 检查各产品的限制。 文件大小和地址数量限制因产品而异；API 文档中列出了当前的限制。
请保留原始导出文件，稍后您需要将结果与该文件进行合并。
启动任务并轮询状态
批量任务通过 POST /api/v1/bulk-tasks 提交，并上传准备好的文件。该调用不会直接返回结果；它会创建一个在后台运行的任务。这是与实时检测的关键区别：单次检测和同步多地址检测会在同一响应中返回结果，而批量任务则需要后续查询。
使用 GET /api/v1/bulk-tasks/{id} 检查进度。轮询频率不要超过每 30 秒一次；过于频繁的循环只会增加请求量，而不会加快任务完成速度。当状态报告为 success 时，响应中会包含一个 CSV 下载链接。该链接有效期为 12 小时，再次查询同一任务可以刷新链接，因此不必担心错过窗口期。
如果准备阶段失败（例如文件包含不支持的内容），任务将不会继续计费。请修复文件后重新提交。
读取结果 CSV
可达性任务会返回一份 CSV 文件。它将每个地址与一个标识其是否可投递的标记配对。头像检测任务会增加一列用于显示公共头像及其链接；即使找到了头像，该链接也可能为空。
将行分为三组：
| 组别 | 检测时的含义 | 典型操作 |
|---|---|---|
| 可投递 | 该地址可以接收邮件 | 保留在列表中 |
| 不可投递 | 该地址无法接收邮件 | 抑制或修正 |
| 无法判定或缺失 | 无完整结果，例如 Catch-All 域名 | 单独存放；不要将其视为上述任何结论 |
缺失或无法判定的行不属于不可投递结论。只有已完成的结果才会计费，因此无法判定的行不会被扣费。
应用结果
将结果 CSV 与您的原始导出文件按地址列进行合并，然后将结论写入 CRM 或发送工具的字段中，而不是直接删除行。这样可以保留审计追踪，并允许您仅对发生变化的记录重新运行检测。
养成两个习惯有助于提升效果。首先，在发送或导入前进行检测，因为结果仅描述地址在检测时的状态，不代表其未来的状态。这是列表清理工作的一部分，应与您自己的抑制记录和许可记录结合使用。
对于较小规模的后续处理（例如几百个新注册用户），使用 1 到 100 个地址的同步多地址调用比创建新的批量任务更简单。
常见问题解答
团队如何知道批量任务何时完成？
以 30 秒或更长的间隔轮询任务状态端点。当状态报告为 success 时，响应中会包含指向结果 CSV 的链接。该链接有效期为 12 小时，且可以通过查询同一任务进行刷新，因此无需立即下载。
无效地址的行会怎样？
无效和重复的行会在文件准备过程中被移除。格式无效不属于不可投递结论；它仅仅是不可检测的地址。提前清理文件可以使准备好的数量接近团队的预期。
可以通过 MCP 从 AI 客户端启动批量任务吗？
MCP 端点未记录批量文件任务工具。MCP 支持单次检测、每次调用最多 100 个地址、产品列表查询和余额查询。批量文件任务需使用 Web 工作流程或 REST API。
了解更多
选择符合您工作流程下一步的产品信息。