邮箱可达性检测 API：处理可达与不可达结果

集成邮箱可达性检测 API，以在同步和批量工作流中区分可达地址、不可达地址以及不确定的 Catch-All 域名。

EmailCheckPro 提供了一款邮箱可达性检测 API，用于在检测时确定地址是否可达（能够接收邮件）或不可达。可达判定表示该地址在检测时可以接收消息，而不可达判定则识别出无法接收邮件的地址。该服务无需向目标收件人发送消息即可评估几乎任何域名的地址。通过集成实时和批量 API 工作流，工程团队可以将活跃的收件人地址与不可达记录及不确定的 Catch-All 域名分离开来，从而在保持摄入系统数据卫生的同时提高传输质量。

核心可达性判定与操作范围

评估收件人地址需要明确区分可达、不可达和不确定的结果。

可达判定确认收件人地址在验证时是可触达的，并准备好接收邮件。相反，不可达结果表示该地址无法接收消息。这两个判定均代表已完成的验证结果。

可达性评估提供的是即时可触达性信号，而非持久的保证。开发团队使用这些信号从通信队列中移除无效地址，这有助于在遵守 GDPR Article 5 (Regulation (EU) 2016/679) 下的欧洲数据最小化原则的同时，保护基础设施性能。

用于单次和批量检测的同步集成

在注册或更新个人资料时捕获联系数据的应用程序需要快速、同步的评估。EmailCheckPro 为交互式工作流提供了两个专门的实时端点。

对于单个提交，开发人员使用单个完整地址查询 POST /api/v1/check。

在处理少量用户输入时，POST /api/v1/batch-check 可在单个 HTTP 请求中同步处理 1 到 100 个地址。多项检测响应会保持输入列表的精确顺序。每条记录除了包含验证详情外，还包含一个 exists 属性。在此模式下，exists=false 表示服务未针对该条目生成已完成的结果，而非不可达判定。这种区分允许摄入系统在安全过滤已确认的不可达条目的同时，对瞬时问题进行重试。

用于列表处理的异步批量任务

维护大型数据库存档需要异步处理架构。在审计联系人存储时，系统通过 POST /api/v1/bulk-tasks 提交验证作业。

批量提交接受包含每行一个完整邮箱地址的结构化 TXT 或 CSV 文件。在文件摄入期间，平台会自动删除重复行和格式错误的条目，以准备一个干净的任务。每个产品均适用记录计数限制；团队应查阅官方文档以获取当前的作业限制。

由于批量作业是异步执行的，应用程序需使用 GET /api/v1/bulk-tasks/{id} 监控进度。客户端工作流轮询此端点的频率不应超过每 30 秒一次。处理完成后，该端点会提供一个 result_url，链接到一个包含每个标识符及其激活结果的 CSV 文件。生成的下载链接有效期为 12 小时，且每次查询该任务状态时都会刷新。

处理不确定的 Catch-All 与格式异常

可靠的数据质量管道必须区分明确的可达性失败与模糊或格式错误的输入。

根据 RFC 5322: Internet Message Format，邮箱地址由本地部分和域名组成，中间由 @ 符号连接。如果传入的条目缺少此结构，API 会将该负载视为格式无效。无效格式与不可达判定不同，它代表结构语法错误。

Catch-all 邮件服务器构成了另一个操作类别。这些域名接受发送给任何任意本地用户名的消息，从而阻止验证引擎明确隔离有效的邮箱。EmailCheckPro 不会进行猜测，而是将 Catch-all 配置标记为不确定。在实时验证中，Catch-all 域名会返回状态码 42200，且没有已完成的结果。不确定、无效和失败的检测不会产生费用，这允许团队将 Catch-all 记录路由到单独的审查队列中。

常见问题解答

不可达判定与不确定结果有何区别？

针对 Catch-all 域名的实时检测会返回状态码 42200，且不包含已完成的判定，这些地址不会被计费，并可用于单独的审查策略。

多项检测 API 请求与异步批量任务有何不同？

多项检测调用使用 POST /api/v1/batch-check 同步验证 1 到 100 个地址，直接在 HTTP 响应中返回结果，同时保持输入顺序。异步批量任务使用 POST /api/v1/bulk-tasks 处理大型 TXT 或 CSV 列表。批量任务在后台运行，需要以 30 秒为间隔轮询 GET /api/v1/bulk-tasks/{id}，并通过有效期为 12 小时的 result_url 输出可下载的 CSV。

了解更多

选择适合您工作流下一步的产品信息。

• 查看产品文档 →
• 联系团队 →