跳到主要内容

批量邮箱检测

对邮箱地址进行批量检测，验证语法、DNS、SMTP 等多维度有效性。当前为同步实现，单次耗时约 5～30s。

请求信息​

  • 获取公私钥：ACCESSKEY_ID:ACCESSKEY_SECRET
  • 请求方法：POST
  • 请求路径：/api/v1/email/BatchVerifyEmail
  • Content-Type：application/json
  • 限流策略：5 QPS，突发 5

注意事项​

  • Emails 当前最多支持 1 个邮箱地址
  • 超出 QPS 限制将返回错误码 215209
  • 大批量验证建议通过 uSpeedo 控制台上传 Excel 文件进行处理
  • 目前支持的邮箱域名：gmail.com、outlook.com、hotmail.com、qq.com、163.com、gmx.de、alice.it，其他域名邮箱将返回 ResultStatus: 2（Uncertain）。我们将持续扩充支持的邮箱，如有需要可联系我们
  • API 检测与控制台检测适用相同的计费规则，详见邮箱校验计费与额度
Emailsstring[]必填
邮箱地址列表，最多 1 个
?

响应格式​

字段名类型说明
RetCodeint错误码，0 表示成功
Messagestring错误信息
RequestUuidstring请求唯一标识
Actionstring接口标识 BatchVerifyEmail
Dataobject验证结果数据

Data 字段​

字段名类型说明
SessionNostring本次批量验证的会话 ID (UUID)
TotalCountint总邮箱数量
SuccessCountint成功验证数量
FailCountint失败数量（含格式错误+服务错误）
Resultsarray成功验证的邮箱结果列表
FailContentarray失败详情列表

Results 项（BatchVerifyEmailResultItem）​

字段名类型说明
Emailstring邮箱地址
ResultStatusint综合结果：0=Valid, 1=Invalid, 2=Uncertain, 3=Risky, 4=Pending
RiskTagint风险标签：0=None, 1=Disposable, 2=Gibberish, 3=SpamTrap, 4=PublicMailbox
SyntaxStatusint语法检查：0=Pending, 1=Pass, 2=Fail, 3=Skip, 4=Unknown
DnsStatusintDNS 检查：0=Pending, 1=Pass, 2=Fail, 3=Skip, 4=Unknown
DisposableStatusint一次性邮箱检查：0=Pending, 1=Pass, 2=Fail, 3=Skip, 4=Unknown
PublicMailboxStatusint公共邮箱检查：0=Pending, 1=Pass, 2=Fail, 3=Skip, 4=Unknown
GibberishStatusint乱码检测：0=Pending, 1=Pass, 2=Fail, 3=Skip, 4=Unknown
SmtpStatusintSMTP 验证：0=Pending, 1=Pass, 2=Fail, 3=Skip, 4=Unknown
CatchAllStatusintCatch-All 检测：0=Pending, 1=Pass, 2=Fail, 3=Skip, 4=Unknown
SpamTrapStatusintSpamTrap 检测：0=Pending, 1=Pass, 2=Fail, 3=Skip, 4=Unknown

FailContent 项（BatchVerifyEmailFailContent）​

字段名类型说明
Emailstring邮箱地址
Reasonstring失败原因

错误码​

RetCode说明
0成功
214403Missing Parameter [Emails]
214405Invalid Parameter，Emails 数量超 1 个上限
214406Internal Service Error
215209Email verification rate limit exceeded（QPS 超限）

语言

凭证

👁️
🔒
🔑登录获取 ACCESSKEY_ID 和 ACCESSKEY_SECRET

请求地址

POST
CURL 请求▼
curl -X POST "https://api.uspeedo.com/api/v1/email/BatchVerifyEmail" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -H "Authorization: Basic $(echo -n 'ACCESSKEY_ID:ACCESSKEY_SECRET' | base64)" \
  -d '{
  "Emails": [
    "example@example.com"
  ]
}'

响应

点击“发起请求”后，可在此查看响应结果。