Overview
Validador de E-mail
Seção intitulada “Validador de E-mail”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
POST /email-validation-batchescom arquivo (.csv/.txt) ou lista JSON;- acompanhe em
GET /email-validation-batches/{id}; - 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.
