Agentscan

邮箱检查

在接受注册前检查邮箱地址:语法、一次性邮箱域名、邮件服务器、拼写错误和职能邮箱。

检查邮箱地址

POST/v1/email/check
API 密钥1 次请求

参数

  • emailstring必填

    要检查的地址,最多 320 字节。GET 请求用 ?email= 传入。

响应字段

  • emailstring

    被检查的地址,域名转为小写。

  • statusstring

    valid、invalid、risky 或 unknown。

  • reasonstring | null

    原因:syntax、no_mx、null_mx、disposable、typo、role、dns_error 或 quota。valid 时为 null。

  • suggestionstring | null

    当域名像某个常用邮箱域名的拼写错误时,给出修正后的地址。

  • domainstring

    ASCII 形式的域名(IDN 已转换)。

  • checksobject

    决定状态的每一项检查。

  • checks.mxboolean | null

    该域名可以接收邮件。未查询 DNS 或 DNS 未响应时为 null。

  • checks.disposableboolean

    该域名提供一次性邮箱。

  • checks.roleboolean

    共享邮箱,例如 info@ 或 support@。

  • checks.freeProviderboolean

    免费邮箱服务商,例如 Gmail 或 Outlook。

  • mailboxstring

    始终为 not_checked:不探测邮箱本身。

curl -X POST https://ipscanner.io/v1/email/check \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"jane@outlok.com"}'
响应
{
  "email": "jane@outlok.com",
  "status": "risky",
  "reason": "typo",
  "suggestion": "jane@outlook.com",
  "domain": "outlok.com",
  "checks": {
    "syntax": true,
    "mx": true,
    "disposable": false,
    "role": false,
    "freeProvider": false
  },
  "mailbox": "not_checked"
}