技能名称: billionverify
详细描述:

BillionVerify API 技能

调用 BillionVerify API 来验证电子邮件地址——支持单个、批量或批量文件处理。

设置

API 密钥必须设置在环境变量 BILLIONVERIFYAPIKEY 中。
在此处获取您的 API 密钥：https://billionverify.com/auth/sign-in?next=/home/api-keys

基础 URL

https://api.billionverify.com

身份验证

所有请求都需要一个 API 密钥标头：
bash
-H BV-API-KEY: $BILLIONVERIFYAPIKEY

端点

验证单个电子邮件

bash curl -X POST https://api.billionverify.com/v1/verify/single \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY \ -H Content-Type: application/json \ -d { email: user@example.com, check_smtp: true }

响应包括：status（有效/无效/未知/风险/一次性/全收/角色）、score（0-1）、isdeliverable、isdisposable、iscatchall、isrole、isfree、domain、domainage、mxrecords、domainreputation、smtpcheck、reason、suggestion、responsetime、credits_used。

验证批量电子邮件（最多 50 个）

bash curl -X POST https://api.billionverify.com/v1/verify/bulk \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY \ -H Content-Type: application/json \ -d { emails: [user1@example.com, user2@example.com], check_smtp: true }

上传文件进行批量验证

上传 CSV、Excel（.xlsx/.xls）或 TXT 文件（最大 20MB，100,000 封电子邮件）： bash curl -X POST https://api.billionverify.com/v1/verify/file \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY \ -F file=@/path/to/emails.csv \ -F check_smtp=true \ -F email_column=email \ -F preserve_original=true

返回用于跟踪异步任务的 task_id。

获取文件任务状态

支持带有 timeout 参数（0-300 秒）的长轮询： bash curl -X GET https://api.billionverify.com/v1/verify/file/{task_id}?timeout=30 \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY

状态值：pending、processing、completed、failed。

下载验证结果

不带过滤器时返回重定向到完整结果文件。带过滤器时返回匹配电子邮件的 CSV（过滤器使用 OR 逻辑组合）： bash curl -X GET https://api.billionverify.com/v1/verify/file/{task_id}/results?valid=true&invalid=true \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY \ -L -o results.csv

过滤器参数：valid、invalid、catchall、role、unknown、disposable、risky。

获取积分余额

bash curl -X GET https://api.billionverify.com/v1/credits \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY

创建 Webhook

bash curl -X POST https://api.billionverify.com/v1/webhooks \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY \ -H Content-Type: application/json \ -d { url: https://your-app.com/webhooks/billionverify, events: [file.completed, file.failed] }

secret 仅在创建时返回——请安全存储。

列出 Webhook

bash curl -X GET https://api.billionverify.com/v1/webhooks \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY

删除 Webhook

bash curl -X DELETE https://api.billionverify.com/v1/webhooks/{webhook_id} \ -H BV-API-KEY: $BILLIONVERIFYAPIKEY

健康检查（无需身份验证）

bash curl -X GET https://api.billionverify.com/health

积分与计费

• - 无效 / 未知：0 积分（免费）
• 所有其他状态（有效、风险、一次性、全收、角色）：各 1 积分

速率限制

端点	限制
单个验证	6,000/分钟
批量验证

1,500/分钟 | | 文件上传 | 300/分钟 | | 其他端点 | 200/分钟 |

用户请求

$ARGUMENTS