隔离 · 验证 API

邮件验证 API

在地址采集时立即验证。提前发现拼写错误、一次性邮箱和高风险地址,避免损害名单质量和发件声誉。

cURL Node SMTP
# 通过 routing policy 发送关键邮件
curl -sS -X POST 'https://app.sendarix.com/v1/email/send' \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: YOUR_API_KEY' \
  -H 'Idempotency-Key: otp_8842' \
  -d '{"to":"user@acme.com","template":"password_reset","routing_policy":"transactional-critical"}'
const sendarix = require("sendarix")(process.env.SENDARIX_KEY);

await sendarix.email.send({
  to: "user@acme.com",
  template: "password_reset",
  routingPolicy: "transactional-critical",
  idempotencyKey: "otp_8842"
});
# Drop-in SMTP — 保留集成并获得 control plane
host:     smtp.sendarix.com
port:     587  (STARTTLS)
username: "your_sending_key"
header:   X-Sendarix-Policy: transactional-critical

发送前验证

每一次 hard bounce 都始于本应被捕获的地址。

错误地址会损失成本和声誉。采集点验证能在邮件触及发件声誉之前阻止不可投递地址。

错误地址的常见来源:拼写错误(user@examplecon.com)、一次性域名(mailinator.com)、角色账号(info@admin@)以及经常 bounce 或 complaint 的高风险域名。

执行的验证检查

每个地址都会经过多项检查。Syntax 很快但较浅;MX lookup 能发现大多数不可投递地址。

Syntax 验证

符合 RFC 5321/5322 的格式检查。拒绝缺少 @、非法字符或错误 domain label 的地址。

MX record lookup

通过 MX DNS records 验证域名是否接收邮件,这是发现 syntax 无法识别的域名拼写错误的关键检查。

一次性邮箱检测

检查已知一次性邮箱提供商的实时数据库。这类地址通常快速 bounce、指向 spam trap,并且没有业务价值。

角色账号检测

识别属于群组而非个人的 role-based 地址(info@admin@support@),这类地址互动较差。

Deliverability score

每个地址根据历史数据、domain reputation 和风险因素获得 0-100 分。可在 signup 阶段设置最低阈值。

Suggestion engine

检测到拼写错误时,API 返回修正建议:user@gmial.com -> user@gmail.com,自动捕获常见域名错误。

API request 与 response

验证单个地址

GET /v1/validate?address=user@example.com
Authorization: Bearer sk_live_...

可投递 response

{
  "address": "user@example.com",
  "result": "deliverable",
  "score": 92,
  "checks": {
    "syntax": "pass",
    "mx": "pass",
    "disposable": "pass",
    "role_account": "pass"
  },
  "suggestion": null,
  "risk_factors": []
}

高风险 response

{
  "address": "user@mailinator.com",
  "result": "undeliverable",
  "score": 0,
  "checks": {
    "syntax": "pass",
    "mx": "pass",
    "disposable": "fail",
    "role_account": "pass"
  },
  "suggestion": null,
  "risk_factors": ["disposable_email_domain"]
}

在应用中何处验证

注册表单

在 blur 或 submit 时验证,并对拼写错误显示 inline correction。仅这一点就可在新用户获取流程中减少 15-30% bounce rate。

Checkout 与账号创建

交易完成前验证。不可投递的确认邮件意味着出现问题时客户没有购买记录。

Import 与 bulk upload

添加到名单前验证所有地址。大规模导入通过 webhook 异步返回结果;只添加确认可投递地址。

Onboarding email capture

如果在 onboarding wizard 中采集 email,就在那里验证,在用户仍愿意修正错误时捕获问题。

验证阈值

并非每个失败都应该阻止用户。按风险承受能力设置阈值。

允许

Score 80+。所有关键检查通过。可安全发送。

复核

Score 50-79。向用户建议修正,并标记为重新验证。

阻止

Score 低于 50。一次性域名、没有明确建议的拼写错误,或 MX failure。

几分钟内集成 email validation

REST API 提供 Python、Node.js、Ruby 和 Go SDK。验证结果可在 100ms 内返回,适合实时表单集成。