电子邮件验证 API 文档
入门
所有 API 请求都需要使用 API 密钥进行验证。您可以在仪表板中找到您的 API 密钥。
标题"x-api-key: your-api-key"单一验证
验证单个电子邮件地址或域的有效性、一次性状态、隐私服务和可送达性。
终点
GET /v1/verify参数
| 名称 | 类型 | 需要 | 说明 |
|---|---|---|---|
| input | string | 是 | 要验证的电子邮件地址或域名(如 [email protected] 或 example.com) |
apiDocs.responseFields
| 现场 | 说明 |
|---|---|
| valid | 表示电子邮件格式是否正确 |
| block | 表示是否应阻止电子邮件(如果一次性、隐私、applePrivateEmail、可送达或 catch_all 为 true,则为 true)。 |
| disposable | 确定电子邮件地址是临时电子邮件地址还是一次性电子邮件地址 |
| privacy | 确定邮件服务器是否使用了电子邮件别名或转发器 |
| applePrivateEmail | 表示该电子邮件是否为 Apple 专用电子邮件地址 |
| deliverable | 检查邮箱是否存在并能接收邮件 |
| domain | 电子邮件地址的域名部分 |
| email_address | 电子邮件地址 |
| catch_all | 表示网域是否具有接收所有电子邮件的配置,即无论收件人地址如何,均可接收所有收到的电子邮件 |
| mx_found | 表示域名是否有有效的邮件服务器(MX 记录) |
| remaining_credits | 账户中剩余的 API 点数 |
答复示例
{
"valid": true,
"block": false,
"disposable": false,
"privacy": false,
"applePrivateEmail": false,
"deliverable": true,
"domain": "example.com",
"email_address": "[email protected]",
"catch_all": false,
"mx_found": true,
"error": null,
"remaining_credits": 99
}代码示例
curl "https://api.verify-email.app/v1/[email protected]" \
-H "X-API-Key: your-api-key"试一试
您需要一个 API 密钥来测试端点。
试试吧
批量验证
在一次请求中验证多个电子邮件地址或域(最多 100 个项目)。
终点
POST /v1/verify/batch参数
| 名称 | 类型 | 需要 | 说明 |
|---|---|---|---|
| inputs | array of strings | 是 | 要验证的电子邮件地址或域阵列 |
代码示例
curl -X POST "https://api.verify-email.app/v1/verify/batch" \
-H "Content-Type: application/json" \
-H "X-API-Key: your-api-key" \
-d '{
"inputs": [
"[email protected]",
"[email protected]"
]
}'试一试
您需要一个 API 密钥来测试端点。
尝试使用不同的域名: