📮 邮箱验证 API

格式 / MX / SMTP 有效性校验 + 验证码发送与校验 · 基础地址：https://email.xn--yet07uxvggp2bm4m.icu
鉴权：所有接口都必须携带 API Key，两种方式任选其一： ① URL 参数 ?key=你的KEY；② 请求头 X-API-Key: 你的KEY。
返回统一格式：{"code":0,"msg":"...","data":{...}}，code=0 表示成功。

1. 健康检查

GET/ping（无需 Key） 
curl "https://email.xn--yet07uxvggp2bm4m.icu/ping"

2. 校验邮箱有效性

GET/check?email=xxx@example.com 
curl "https://email.xn--yet07uxvggp2bm4m.icu/check?key=你的KEY&email=test@qq.com"
返回字段说明
data.syntax格式是否合法
data.mx域名是否有邮件服务器
data.smtpok / rejected / unreachable / unknown
data.deliverabletrue=可投递，false=不可投递，null=无法确定
SMTP 探测依赖出站 25 端口（本服务器已被云厂商封禁），结果多为 unreachable，属正常现象，不代表邮箱无效。

3. 发送验证码

POST/send  body：{"email":"xxx@example.com"}（支持 JSON 或表单） 
curl -X POST "https://email.xn--yet07uxvggp2bm4m.icu/send?key=你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"test@qq.com"}'
未配置 SMTP 时自动进入模拟模式：不会真实发信，验证码在响应 data.debug_code 中返回，方便联调。配置好 SMTP 后即真实发信。

4. 校验验证码

POST/verify  body：{"email":"xxx","code":"123456"} 
curl -X POST "https://email.xn--yet07uxvggp2bm4m.icu/verify?key=你的KEY" \
  -H "Content-Type: application/json" \
  -d '{"email":"test@qq.com","code":"123456"}'
验证码 10 分钟有效、每个码最多校验 5 次、验证通过后立即作废。

错误码速查

code含义
0成功
1001缺少或无效 API Key
1002缺少参数
1003邮箱格式不合法
1004邮箱不可投递
2001发送过于频繁（冷却中）
2002超过每小时发送/校验上限
2003邮件发送失败（SMTP 错误）
3001尚未发送验证码
3002验证码已过期
3003验证码错误
3004验证次数过多