Isolar · API de validação

API de validação de email

Valide endereços no ponto de captura. Detecte erros, emails descartáveis e endereços de alto risco antes que prejudiquem sua lista e reputação.

cURL Node SMTP
# Enviar email crítico por uma 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"
});
# SMTP drop-in — mantenha sua integração e ganhe um control plane
host:     smtp.sendarix.com
port:     587  (STARTTLS)
username: "your_sending_key"
header:   X-Sendarix-Policy: transactional-critical

Valide antes de enviar

Todo hard bounce começa com um endereço que deveria ter sido capturado.

Endereços ruins custam dinheiro e reputação. A validação no ponto de captura evita email não entregável antes de afetar sua reputação de envio.

Fontes comuns de endereços ruins: erros de digitação (user@examplecon.com), domínios descartáveis (mailinator.com), contas de função (info@, admin@) e domínios de alto risco que geram bounce ou complaint.

Verificações de validação executadas

Cada endereço passa por várias verificações. Sintaxe é rápida, mas superficial; lookup MX captura a maioria dos endereços não entregáveis.

Validação de sintaxe

Verificação de formato compatível com RFC 5321/5322. Rejeita endereços malformados: falta de @, caracteres inválidos ou labels de domínio incorretos.

Lookup de registros MX

Verifica se o domínio aceita email consultando registros MX DNS; a checagem mais importante para pegar erros de domínio que a sintaxe não vê.

Detecção de email descartável

Consulta um banco realtime de provedores descartáveis conhecidos. Eles geram bounce rapidamente, indicam spam traps e não oferecem valor de negócio.

Detecção de contas de função

Identifica endereços baseados em função (info@, admin@, support@) que pertencem a grupos e têm baixo engajamento.

Score de deliverability

Cada endereço recebe um score de 0-100 com base em dados históricos, reputação do domínio e fatores de risco. Aplique um mínimo no signup.

Motor de sugestões

Ao detectar erro, a API retorna correção: user@gmial.com -> user@gmail.com, capturando erros comuns de domínio automaticamente.

Request e response da API

Validar um único endereço

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

Response entregável

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

Response de alto risco

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

Onde validar na sua aplicação

Formulários de signup e registro

Valide no blur ou submit, mostrando correção inline. Isso pode reduzir bounce rates em 15-30% em fluxos de aquisição.

Checkout e criação de conta

Valide antes de concluir a transação. Uma confirmação não entregável significa que o cliente fica sem registro da compra se algo der errado.

Importação e upload em massa

Valide todos os endereços antes de adicioná-los à lista. Em grandes imports, os resultados retornam por webhook; adicione apenas endereços confirmados como entregáveis.

Captura de email no onboarding

Se você captura email durante um wizard de onboarding, valide ali enquanto o usuário ainda está engajado para corrigir um erro.

Limites de validação

Nem toda falha deve bloquear um usuário. Configure limites conforme sua tolerância a risco.

Permitir

Score 80+. Todas as checagens críticas passam. Seguro para enviar.

Revisar

Score 50-79. Sugira correção ao usuário e marque para revalidação.

Bloquear

Score abaixo de 50. Domínio descartável, erro sem sugestão clara ou falha MX.

Integre email validation em minutos

REST API com SDKs para Python, Node.js, Ruby e Go. Resultados retornam em menos de 100 ms para integração realtime em formulários.