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"
}