Email Validator: Disposable

Verificar descartável

Diz em milissegundos se um endereço ou domínio é descartável ou de alto risco, para você bloquear cadastros falsos. Não conversa com o servidor da caixa de email: para isso, use Validate Email.

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

Requer o escopo tools:validate na sua API key.

i

Usa 1 crédito de disposable (não um crédito de validação). Planos ilimitados nunca são cobrados.

i

Envie email ou domain. Com um email, a reputação de fraude do endereço também é verificada.

Argumentos

  • emailstringopcional

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

    ex.: "john@mailinator.com"

  • domainstringopcional

    Só o domínio, quando você não tem o endereço completo.

    ex.: "mailinator.com"

Início rápido

import axios from 'axios';

const response = await axios.post(
  'https://g.sendcorex.com/v1/tool/validate',
  {
    commands: [
      {
        command: "check_disposable",
        args: {
          email: "john@mailinator.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": "check_disposable",
      "id": "0",
      "type": "SUCCESS",
      "took_ms": 2,
      "data": {
        "email": "john@mailinator.com",
        "domain": "mailinator.com",
        "is_disposable": true,
        "high_risk": true,
        "code": "fully_confirmed",
        "reason": "Confirmed",
        "checks": [
          {
            "check": "Domain Blocklist Match",
            "status": "Failed",
            "details": "Domain found in known disposable list"
          }
        ],
        "unlimited": false,
        "remaining_credits": 4999
      }
    }
  ]
}

Campos da resposta

  • email

    O endereço que você enviou, sem espaços e em minúsculas. null quando você enviou só um domain.

  • domain

    O domínio que foi verificado.

  • is_disposable

    true para provedores temporários/descartáveis. Bloqueie o cadastro.

  • high_risk

    true quando o endereço é descartável OU já foi marcado por fraude na Sendcorex. Bloqueie ou mande para revisão.

  • code

    fully_confirmed quando algo foi encontrado, clear quando nada foi.

  • reason

    Uma explicação curta do veredito.

  • checks

    As verificações que rodaram (check, status, details). Veja Verificações abaixo.

  • remaining_credits

    Créditos de disposable restantes após esta verificação. null em um plano ilimitado.

  • unlimited

    true em um plano ilimitado.

Verificações

Da mais barata para a mais lenta. Um domínio na blocklist responde na hora, sem nenhuma consulta DNS.

  • Email Reputation Check

    Só aparece quando falha: o endereço foi marcado por fraude na Sendcorex. Define high_risk, não is_disposable.

  • Domain Blocklist Match

    O domínio é um provedor descartável conhecido. Quando falha, nada mais roda: a resposta volta na hora.

  • MX Record Check

    O domínio está hospedado em infraestrutura usada por provedores descartáveis, mesmo que ainda não esteja em nenhuma lista.

  • MX Record Present

    Informativa: o domínio tem registros MX. Um domínio sem MX não pode receber email (geralmente um erro de digitação), mas isso sozinho não o torna descartável.

Usando o resultado

  • Formulários de cadastro

    Chame antes de criar a conta. Quando is_disposable for true, peça outro endereço.

  • Alto risco

    high_risk sem is_disposable é uma caixa real marcada por fraude na Sendcorex. Bloqueie ou segure a conta para revisão.

  • Disposable vs. Validate Email

    Esta verificação é instantânea e barata. Validate Email também pergunta ao servidor da caixa se o endereço existe, o que leva segundos: use-o 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.

  • CMDINTERNAL

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