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.
# 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.
Score 80+. Todas as checagens críticas passam. Seguro para enviar.
Score 50-79. Sugira correção ao usuário e marque para revalidação.
Score abaixo de 50. Domínio descartável, erro sem sugestão clara ou falha MX.
Produtos relacionados
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.
