Pular para o conteúdo

Overview

Verificar endereços de e-mail, avulsos ou em lote.

Qual dos dois usar

um endereço, agora POST /email-validations — a resposta vem na mesma requisição. O caso do formulário de cadastro
uma lista POST /email-validation-batches — responde 201 e o resultado é consultado depois. Custa uma requisição, não uma por endereço

⚠️ A verificação avulsa tem teto por minuto, porque ela abre conexão com o servidor de destino a cada chamada. Um laço sobre uma lista viraria uma enxurrada de conexões saindo do nosso IP — que é como um IP entra em lista negra. Para muitos endereços, lote.

O caminho do lote

  1. POST /email-validation-batches com arquivo (.csv/.txt) ou lista JSON;
  2. acompanhe em GET /email-validation-batches/{id};
  3. leia o resultado em GET /email-validation-batches/{id}/validations, que sai na ordem do arquivo.

⚠️ Quem encerra é status, não progress. Um lote pode marcar 100% e ainda não ter conciliado os contadores: espere completed ou failed.

O campo que decide, e o que null significa

send.status é o veredito: deliverable aceita, undeliverable recusa, risky aceita com ressalva.

⚠️ unknown não é “ruim”. Ele diz que a verificação não concluiu, e o motivo costuma ser nosso — o servidor de destino recusou a conversa. Tratá-lo como undeliverable descarta endereços válidos, e esses casos não são cobrados, justamente por isso.

A mesma régua vale para os sinalizadores de result: eles têm três valores, e null quer dizer não sabemos, nunca não. Para listar o que merece nova tentativa, filtre valid=unknown.

Crédito e retenção

Um crédito por endereço validado. Não cobram: e-mail repetido no mesmo arquivo, da segunda ocorrência em diante, e endereço cuja verificação não concluiu.

O resultado de cada endereço fica 30 dias; os contadores do lote permanecem depois disso, e items_pruned_at marca quando a lista detalhada saiu.