Verificar um único endereço

Este guia mostra como conferir um endereço de e-mail, manualmente no painel ou pelo seu código com a API. Ele também mostra como usar a verificação em um formulário de inscrição para barrar erros de digitação e endereços descartáveis antes que cheguem à sua lista.

Antes de começar

• Cada verificação custa 5 créditos. Confira o seu saldo na barra lateral ou em Workspace›Billing.
• Para a API, use uma chave de API com Full Access. As chaves só de envio não podem verificar endereços.

Modos fast e full

Os dois modos custam o mesmo. O full demora mais porque conversa com o servidor de e-mail do destinatário, que pode ser lento ou se recusar a responder. Alguns grandes provedores bloqueiam essas verificações, então o full nem sempre consegue confirmar uma caixa de e-mail. Consulte Resultados da verificação para saber o que cada verificação significa.

Verificar um endereço

curl https://api.emailit.com/v2/email-verifications \
  -X POST \
  -H "Authorization: Bearer $EMAILIT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "email": "ada@example.com", "mode": "full" }'

{
  "id": "ev_6Hq2Lm9Tx4Pz",
  "object": "email_verification",
  "email": "ada@example.com",
  "status": "completed",
  "score": 100,
  "risk": "low",
  "result": "safe",
  "mode": "full",
  "checks": {
    "valid_syntax": true,
    "disposable": false,
    "role_account": false,
    "inbox_full": false,
    "deliverable": true,
    "disabled": false,
    "free_email": false,
    "gibberish": false,
    "catch_all": false,
    "smtp_connect": true,
    "has_mx_records": true,
    "domain_age": 10957
  },
  "address": {
    "mailbox": "ada",
    "domain": "example.com",
    "suffix": null,
    "root": "ada@example.com"
  },
  "did_you_mean": null,
  "mx_records": [
    { "priority": 10, "exchange": "mx1.example.com" }
  ],
  "created_at": "2026-10-01T10:24:11Z",
  "updated_at": "2026-10-01T10:24:11Z"
}

Verificar endereços no cadastro

Conferir um endereço quando alguém o digita é a forma mais barata de manter uma lista limpa. Um erro de digitação barrado no cadastro nunca vira um bounce.

1. Chame a API a partir do seu servidor. Nunca coloque a sua chave de API em código do navegador. Envie o endereço a partir do handler de cadastro, no modo fast.

2. Defina um timeout e deixe passar em caso de falha. Se a verificação estiver lenta ou retornar um erro, deixe o cadastro seguir. Perder um cliente real custa mais do que um endereço ruim.

3. Aja conforme o resultado. Bloqueie o que está claramente errado, sugira correções para erros de digitação e deixe todo o resto passar.

export async function checkSignupEmail(email) {
  const controller = new AbortController();
  const timer = setTimeout(() => controller.abort(), 5000);

  try {
    const res = await fetch('https://api.emailit.com/v2/email-verifications', {
      method: 'POST',
      headers: {
        Authorization: `Bearer ${process.env.EMAILIT_API_KEY}`,
        'Content-Type': 'application/json',
      },
      body: JSON.stringify({ email, mode: 'fast' }),
      signal: controller.signal,
    });
    if (!res.ok) return { ok: true }; // fail open

    const verification = await res.json();

    if (verification.result === 'invalid') {
      return {
        ok: false,
        message: verification.did_you_mean
          ? `Did you mean ${verification.did_you_mean}?`
          : 'Please check your email address.',
      };
    }
    if (verification.result === 'disposable') {
      return { ok: false, message: 'Please use a permanent email address.' };
    }

    // Accept the address, but offer a correction if one looks likely.
    return { ok: true, suggestion: verification.did_you_mean };
  } catch {
    return { ok: true }; // timeout or network error: fail open
  } finally {
    clearTimeout(timer);
  }
}

Algumas dicas:

• Use did_you_mean. Para erros de digitação comuns no domínio, como ada@gmial.com, ele contém o endereço provável, ada@gmail.com. Mostre-o como uma sugestão que a pessoa pode aceitar.
• Não bloqueie endereços genéricos de cara. info@ ou sales@ costumam ser a forma como pequenas empresas se cadastram. Sinalize-os em vez disso.
• Verifique cada endereço uma vez. Cada chamada custa créditos, então verifique quando o formulário for enviado, não a cada tecla digitada, e guarde o resultado.

Veja também