Email Validator: Validação

Validar emails

Valide até 50 endereços em um comando. Eles são verificados em paralelo e voltam na ordem em que você os enviou.

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

Requer o escopo tools:validate na sua API key.

i

1 crédito por endereço distinto. Endereços repetidos são validados e cobrados uma vez, e aparecem uma vez em results.

!

Se seus créditos não cobrirem a lista inteira, nada é validado: você recebe INSUFFICIENT_CREDITS com quantos precisa e quantos tem.

Argumentos

  • emailsstring[]obrigatório

    1 a 50 endereços.

    ex.: ["ana@acme.com", "jhon@gmial.com"]

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/tool/validate',
  {
    commands: [
      {
        command: "validate_emails",
        args: {
          emails: [
            "ana@acme.com",
            "jhon@gmial.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_emails",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 18,
      "data": {
        "results": [
          {
            "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"
              }
            ]
          },
          {
            "email": "jhon@gmial.com",
            "valid": false,
            "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": "Failed",
                "details": "Possible typo. Suggested correction: jhon@gmail.com"
              },
              {
                "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": "Failed",
                "details": "Invalid domain or no MX records"
              }
            ]
          }
        ],
        "count": 2,
        "valid_count": 1,
        "invalid_count": 1,
        "credits_used": 2
      }
    }
  ]
}

Campos da resposta

  • results

    Um resultado por endereço distinto, na ordem em que você os enviou.

  • count / valid_count / invalid_count

    Quantos foram verificados, e quantos voltaram válidos e inválidos.

  • credits_used

    Créditos usados por este comando.

  • results[].email

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

  • results[].valid

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

  • results[].checks[].check

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

  • results[].checks[].status

    Passed ou Failed.

  • results[].checks[].details

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

  • results[].checks[].fullResponse

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

  • results[].checks[].providerId / providerName

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

Listas grandes

Para milhares de endereços, chame este comando em blocos de 50, um depois do outro, ou envie o arquivo no dashboard (Email Validator → Lists): ele é validado em segundo plano e você recebe um email com o CSV quando terminar.

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.