邮箱地址检测email-check

综合性邮箱质量评估接口，一次请求完成 6 项检测： ① RFC 5322 格式校验 ② 临时/一次性邮箱检测（基于 72,345 条开源域名库，3 个数据源合并去重） ③ MX 记录验证（用 AliDNS DoH，避开 PHP getmxrr 不稳定） ④ 拼写纠正（gmial.com → 提示 gmail.com） ⑤ 服务商识别（QQ邮箱/Gmail/网易/Outlook 等 40+ 主流邮箱） ⑥ 综合风险评分 0-100，附详细原因清单典型用例：用户注册时的反垃圾邮箱过滤、邮件营销列表清洗、KYC 风控辅助。

1. 基本信息

接口地址	`https://v1.apizero.cn/api/email-check`
请求方法	`GET`
分类	kyc
提供方	极数本源
计费模式	免费试用
单次消耗	0 积分
起步价	—
QPS 限制	10 req/s
每日免费额度	500 次（已认证用户）
匿名每日额度	100 次（无 API Key）
VIP 免费	否
调用次数

2. 认证

匿名 QPS=3、日 100 次；登录后 QPS=10、日 500 次。

获取 API Key：登录 https://apizero.cn/account/keys

3. 请求参数

参数名	类型	必填	说明	示例
`email`	`string`	是	要检测的邮箱地址，最长 254 字符（RFC 上限）	—

4. 请求头

Header	类型	必填	说明	示例
`X-API-Key`	`string`	否	API Key（不传走匿名额度）	—

5. 请求示例 (cURL)

curl "https://v1.apizero.cn/api/email-check?email=%3Cemail%3E&key=YOUR_API_KEY"

6. 响应字段

字段	类型	说明	示例
`email`	`string`	小写规范化后的邮箱	—
`input`	`string`	原始输入回显	—
`valid_format`	`boolean`	是否符合 RFC 5322 格式	—
`local`	`string`	本地部分（@ 前面，格式无效时为 null）	—
`domain`	`string`	域名部分（@ 后面，格式无效时为 null）	—
`is_disposable`	`boolean`	是否临时/一次性邮箱	—
`disposable_match`	`string\|null`	匹配上的具体临时邮箱域名（可能是上级域名）	—
`is_trusted`	`boolean`	是否知名邮箱服务商	—
`provider`	`string\|null`	服务商中文名（如「QQ 邮箱」「Gmail」）	—
`has_mx`	`boolean`	域名是否配置了 MX 记录	—
`mx_records`	`array`	MX 记录列表（按 priority 升序）	—
`mx_records[].priority`	`integer`	优先级（数字越小越优先）	—
`mx_records[].exchange`	`string`	邮件服务器主机名	—
`mx_records[].ttl`	`integer`	TTL 秒	—
`spelling_suggestion`	`string\|null`	拼写错误建议（疑似拼错知名域名时返回，如 "gmial.com" → "gmail.com"）	—
`risk_score`	`integer`	★ 综合风险评分 0~100（越高越可信）	—
`risk_level`	`string`	风险等级：invalid / high / medium / low	—
`reasons`	`string[]`	判定原因列表（含 ✅/⚠️ 前缀）	—

7. 响应示例

{
    "code": 0,
    "msg": "成功",
    "data": {
        "email": "test@gmial.com",
        "input": "test@gmial.com",
        "valid_format": true,
        "local": "test",
        "domain": "gmial.com",
        "is_disposable": false,
        "disposable_match": null,
        "is_trusted": false,
        "provider": null,
        "has_mx": false,
        "mx_records": [],
        "spelling_suggestion": "gmail.com",
        "risk_score": 5,
        "risk_level": "invalid",
        "reasons": [
            "⚠️ 域名无 MX 记录，无法接收邮件",
            "⚠️ 域名疑似拼写错误，建议用 gmail.com",
            "⚠️ 本地部分含测试/系统类关键词"
        ]
    },
    "request_id": "mota..."
}

8. 错误码

code	status	说明
`0`	`OK`	成功（即使格式错误也返回 200，valid_format=false）
`4000`	`Bad Request`	参数错误：email 缺失 / 长度超过 254
`4011`	`Unauthorized`	API Key 无效
`4013`	`Forbidden`	API Key 已暂停
`4014`	`Forbidden`	当前 IP 不在 API Key 白名单内
`4029`	`Too Many Requests`	QPS 限流
`4030`	`Too Many Requests`	今日免费额度已用完

9. 变更日志

1.0.0(2026-05-06)
- 首次发布：6 项综合检测（格式 / 临时邮箱 / MX / 拼写纠正 / 服务商 / 风险评分）
- 临时邮箱域名库 72,345 条，融合 3 个开源数据源
- MX 验证用 AliDNS DoH，避开服务器 getmxrr 不可用
- 拼写纠正基于 levenshtein 距离 + 首字母 + 长度差三重过滤
- 内置 40+ 中外主流邮箱服务商识别