电子邮件验证 API 文档

应用程序接口状态

入门

所有 API 请求都需要使用 API 密钥进行验证。您可以在仪表板中找到您的 API 密钥。

标题"x-api-key: your-api-key"

单一验证

验证单个电子邮件地址或域的有效性、一次性状态、隐私服务和可送达性。

终点

GET /v1/verify

参数

名称类型需要说明
inputstring要验证的电子邮件地址或域名(如 [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

参数

名称类型需要说明
inputsarray 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 密钥来测试端点。

尝试使用不同的域名: