关于本视频

本视频中的响应都是真实的 API 响应，已做缩短。API 密钥、批量验证和文件验证需要付费账号。

视频文字稿

1. 00:00你的第一个请求

   你的第一个请求是向 /verify/single 发送 POST。发送一个 JSON 字段 email，把你的 API 密钥放在 BV-API-KEY 请求头里。整个请求就这些。把这个密钥保存在服务器的环境变量里，绝不要放在客户端代码中。创建密钥需要付费账号，任意一次积分购买即可解锁。

2. 00:24读懂响应

   这是一个客服地址的真实响应。先看 status。它显示 role，因为 support 是共用邮箱的名字，不是某个人。score 是零点六。这是按固定规则得出的值，不是概率，所以要根据 status 来分支，而不是根据分数。is_deliverable 为 true，说明邮件服务器接受了这个地址。is_catch_all 也为 true，说明这个域名接受任何地址。role 占据了 status，其余情况仍由各个标记显示。reason 以一个代码给出原因，这里是 catch-all deliverable。

3. 01:02为什么 credits_used 是 0

   文档里有一页列出了所有代码。再看 credits_used。这里是零，但这并不表示检查是免费的。这个账号在过去 24 小时内已经检查过这个地址，所以重复检查没有收费。像这样的首次检查消耗一个积分。verification_mode 说明答案来自哪里，这一次来自缓存的历史记录。用它来理解结果，计费则看 credits_used。

4. 01:23最多 50 个地址

   名单很短？用 /verify/bulk。请求头不变，请求体接受一个 emails 数组，最多 50 个地址。结果就在这同一个响应里返回。每个地址都带有你刚才见过的那些字段。第一个是 Catch-all。第二个是无效，因为那个邮箱不存在。第三个是一次性。三个都消耗了一个积分。无效也算。这里一次性也算，是因为这个请求把 check_smtp 设为 true。省略它，一次性匹配会提前停止，不收费。所以默认情况下，未知、语法错误和一次性不收费。其余的都是一个积分，包括 Catch-all 和角色。结果下面是汇总。valid emails 是零，因为 Catch-all 不算有效。分组把这一批归类：一个可用但为 Catch-all，两个不可投递。发送超过 50 个，会得到 HTTP 400，代码 3103。名单不会替你拆分，也不会变成文件任务，错误会把你指向文件端点。

5. 02:28更大的名单

   更大的名单，请上传文件。它是异步的，所以上传会给你一个任务 ID。用这个 ID 查询进度。任务完成后，下载结果。保留 -L 参数，因为下载可能会重定向。下载的是一个 CSV。你的原始列都在，新列跟在后面，比如 ev_status 和 ev_reason。

6. 02:49查看你的积分

   /credits 告诉你还剩多少。它是 GET 请求，请求头相同。大批量上传之前先查一下，因为积分不够时，API 会返回 402。

7. 03:00两个请求选项

   有两个选项会改变检查的做法。SMTP 默认开启，而且从不会发送任何邮件。check_smtp 设为 false 会跳过邮件服务器，所以大多数地址会返回未知。force_refresh 设为 true 会跳过缓存，你需要为新结果付费。

8. 03:17错误与限制

   先处理三种错误。401 是密钥缺失或无效。402 表示积分不足。429 是速率限制，所以要退避后重试。速率限制按 API 密钥计算。single 每分钟 6,000 个请求，bulk 是 1,500。

9. 03:37下一步

   文件上传是每分钟 300 个。快速开始就到这里：single、bulk、文件和积分。完整的 API 参考、SDK 和 Webhook 都在 billionverify.com/docs。每天使用账号即可获得 20 个免费积分，每月最多 600 个，无需信用卡。访问 billionverify.com 开始使用。

本视频中展示的工具