Email Validator: Validação

Validar email

Verifique um endereço antes de enviar para ele: formato, domínio, MX, provedores temporários, erros de digitação, spam traps e se a caixa realmente existe.

POSThttps://g.sendcorex.com/v1/tool/validatecommand: validate_email
i

Requer o escopo tools:validate na sua API key.

i

Usa 1 crédito de validação.

Argumentos

  • emailstringobrigatório

    O endereço a verificar. Até 254 caracteres.

    ex.: "ana@acme.com"

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/tool/validate',
  {
    commands: [
      {
        command: "validate_email",
        args: {
          email: "ana@acme.com"
        }
      }
    ]
  },
  { headers: { Authorization: process.env.SENDCOREX_API_KEY } },
);

const [result] = response.data.results;
if (result.type !== 'SUCCESS') throw new Error(`${result.code}: ${result.message}`);
console.log(result.data);

Resposta

{
  "type": "SUCCESS",
  "results": [
    {
      "command": "validate_email",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 18,
      "data": {
        "email": "ana@acme.com",
        "valid": true,
        "checks": [
          {
            "check": "Format Validation",
            "status": "Passed",
            "details": "Valid email format"
          },
          {
            "check": "Local Part Validation",
            "status": "Passed",
            "details": "Local part is RFC compliant"
          },
          {
            "check": "Role-based Email Check",
            "status": "Passed",
            "details": "Not a role-based address"
          },
          {
            "check": "No-reply Email Check",
            "status": "Passed",
            "details": "Not a no-reply address"
          },
          {
            "check": "Temporary Email Check",
            "status": "Passed",
            "details": "Not a temporary email"
          },
          {
            "check": "Misspelled Domain Check",
            "status": "Passed",
            "details": "Correct"
          },
          {
            "check": "Spam Trap Check",
            "status": "Passed",
            "details": "Not a spam trap"
          },
          {
            "check": "Provider Type",
            "status": "Passed",
            "details": "Corporate or custom domain"
          },
          {
            "check": "Domain Validation",
            "status": "Passed",
            "details": "Domain is valid and has MX records"
          },
          {
            "check": "Null MX Check",
            "status": "Passed",
            "details": "Domain accepts email"
          },
          {
            "check": "Email Provider Detection",
            "status": "Passed",
            "details": "Domain is hosted on a known provider: Google Workspace",
            "providerId": 1,
            "providerName": "Google Workspace"
          },
          {
            "check": "Email Deliverability",
            "status": "Passed",
            "details": "Mailbox exists",
            "fullResponse": "250 2.1.5 OK"
          },
          {
            "check": "Catch-all Mail Exchanger Check",
            "status": "Passed",
            "details": "Mail exchanger correctly rejects nonexistent addresses"
          }
        ]
      }
    }
  ]
}

Campos da resposta

  • email

    O endereço, sem espaços e em minúsculas.

  • valid

    true só quando todas as verificações passaram. Provider Type e Email Provider Detection são informativas e nunca o tornam false.

  • checks[].check

    O nome da verificação. Veja Verificações abaixo.

  • checks[].status

    Passed ou Failed.

  • checks[].details

    Uma frase explicando o resultado, pronta para mostrar a um usuário.

  • checks[].fullResponse

    Só em Email Deliverability: a resposta exata do servidor da caixa.

  • checks[].providerId / providerName

    Só em Email Provider Detection: o provedor de email que hospeda o domínio.

Verificações

Rodam nesta ordem e param cedo quando não faz sentido continuar (sem MX, formato ruim…).

  • Format Validation

    O endereço tem um formato válido. Se falhar, nada mais roda.

  • Local Part Validation

    A parte antes do @ segue a RFC 5322 (tamanho, pontos, caracteres).

  • Role-based Email Check

    Informativa: diz se é um endereço de equipe como info@ ou admin@. Nunca falha.

  • No-reply Email Check

    Falha para noreply@ e endereços parecidos, que não leem o que recebem.

  • Temporary Email Check

    Falha para provedores descartáveis e temporários.

  • Misspelled Domain Check

    Falha para erros comuns de digitação de grandes provedores (gmial.com, hotmial.com…) e sugere o correto.

  • Spam Trap Check

    Falha para domínios conhecidos como spam traps.

  • Provider Type

    Informativa: provedor gratuito/pessoal ou domínio corporativo.

  • Domain Validation

    O domínio existe e tem registros MX.

  • Null MX Check

    Falha quando o domínio declara que não aceita email (RFC 7505).

  • Email Provider Detection

    Informativa: o provedor da caixa, quando o conhecemos.

  • Email Deliverability

    Perguntamos ao servidor da caixa se o endereço existe, sem enviar nada. Só roda quando todas as verificações acima passaram.

  • Catch-all Mail Exchanger Check

    Só para domínios corporativos. Falha quando o servidor aceita qualquer endereço, então a caixa não pode ser confirmada.

Usando o resultado

  • Bloqueie o cadastro

    Quando valid for false, mostre ao usuário os details da primeira verificação que falhou.

  • Sugira a correção

    Misspelled Domain Check vem com o endereço corrigido em details: ofereça com um clique.

  • Catch-all

    Uma verificação de catch-all reprovada significa que o servidor aceita qualquer coisa. O endereço pode existir, mas ninguém consegue provar isso antes de enviar.

Erros

Erros no nível HTTP retornam type, code e message. Erros marcados com CMD voltam dentro do resultado do comando, com HTTP 200.

  • 401INVALID_API_KEY

    A API key não existe, foi revogada ou foi desativada no dashboard.

  • 429RATE_LIMITED

    Mais de 75 requisições/s ou 75 simultâneas para o mesmo IP + API key. Aguarde o número de segundos em Retry-After.

  • CMDMISSING_SCOPE

    A API key não tem `tools:validate`.

  • CMDINVALID_ARGS

    Um argumento é inválido: email ausente (ou domínio, em `check_disposable`), mais de 50 emails, um endereço com mais de 254 caracteres, limit fora do intervalo…

  • CMDINSUFFICIENT_CREDITS

    Você não tem créditos suficientes para o comando inteiro (créditos de validação para `validate_*`, créditos de disposable para `check_disposable`). Nada foi verificado e nada foi cobrado.

  • CMDCREDITS_UNAVAILABLE

    Não foi possível ler seus créditos agora. Nada foi cobrado. Tente de novo.

  • CMDNO_SERVERS_AVAILABLE

    Nenhum servidor de validação está disponível agora. Nada foi cobrado. Tente de novo em instantes.

  • CMDVALIDATION_FAILED

    Os servidores de validação não responderam a tempo. Seus créditos foram devolvidos. Tente de novo.

  • CMDINTERNAL

    Erro no servidor. O detalhe só é gravado no log do servidor.