Como o EmailCheckPro verifica um e-mail

Conclua uma verificação

Esta seção aborda as verificações em tempo real: o painel SaaS e os endpoints REST síncronos compartilham um único serviço de verificação e o mesmo significado de resposta. Listas muito grandes contam com uma opção em massa assíncrona, abordada no final desta página.

1. 1

   Envie um e-mail

   Envie um e-mail completo, conforme descrito na documentação da API.

2. 2

   Use service_type=email

   O produto email verifica se o endereço era entregável — capaz de receber mensagens — no momento da verificação.

3. 3

   Leia o resultado

   Leia registered na mesma resposta. Faça uma nova verificação quando precisar de um status atualizado.

Qual formato de e-mail enviar

O EmailCheckPro aceita um e-mail por verificação: a parte local, um sinal @ e o domínio — por exemplo name@example.com. Qualquer domínio funciona, tanto caixas postais pessoais quanto corporativas. O domínio apenas define qual rota é executada nos bastidores; você nunca escolhe uma. Os endereços são aparados e convertidos para minúsculas antes da verificação, então maiúsculas e espaços soltos nunca alteram o resultado.

• Envie o endereço completo. Uma parte local ou um domínio isolados não podem ser verificados.
• Nomes de exibição e sinais de maior/menor não são aceitos — envie o próprio endereço, não "Name <name@example.com>".
• Endereços de e-mail em formato incorreto são rejeitados antes de qualquer cobrança; um formato rejeitado não é um resultado "não entregável".

O que significa registered?

registered é a resposta de uma verificação de e-mail. Ele só aparece em uma resposta bem-sucedida e é um booleano: true significa que o endereço é entregável (pode receber mensagens) no momento da solicitação, false significa que não é. Qualquer outra coisa — tempo esgotado, resultado indeterminado, endereço inválido — volta como código de erro, e o EmailCheckPro reembolsa essa verificação automaticamente. Portanto, a ausência do campo registered nunca significa "não entregável"; significa que a verificação não produziu resultado. O valor reflete o momento da consulta: contas são criadas e excluídas o tempo todo, então atualize a verificação antes de agir com base em um resultado antigo, em vez de armazená-lo em cache por semanas.

• registered=true significa entregável: o endereço pode receber e-mails.
• registered=false significa não entregável: o endereço não pode receber e-mails.
• Trate os demais desfechos de acordo com o código de resposta da API; não deduza registered por conta própria.

Use o resultado dentro do seu escopo

Uma verificação reflete o status no momento da solicitação. Não é verificação de identidade nem permissão para contatar alguém.

• Não confirma quem é o dono do e-mail, se a pessoa está conectada neste momento nem nada sobre o conteúdo da caixa postal.
• Um resultado entregável não estabelece consentimento para contatar o endereço.
• Faça uma nova verificação quando a decisão de negócio exigir um status atual.

Listas muito grandes: a opção assíncrona

A verificação múltipla do painel e o endpoint múltiplo da API cobrem a maioria das listas. Só quando uma lista excede em muito esses limites faz sentido enviar o arquivo inteiro como uma tarefa assíncrona em massa.

• Envie um .txt ou .csv com um e-mail por linha, pela página de verificação em massa ou pela API.
• A verificação de endereço completo aceita qualquer domínio em um único arquivo; a verificação de avatar cobre Gmail, Yandex e Mail.ru e aceita os três misturados em um único arquivo. Endereços fora desses três fazem a tarefa falhar durante a preparação do arquivo — ele não é enviado para verificação e é reembolsado integralmente.
• O saldo é reservado para as linhas válidas no envio, você é cobrado apenas pelos e-mails que retornam resultado, e a diferença é reembolsada.
• A tarefa é executada em segundo plano; baixe o arquivo de resultado quando terminar. Uma tarefa com falha é reembolsada integralmente.