Orientação de produto
API de Verificação de entregabilidade de e-mail: Lidando com resultados entregáveis e não entregáveis
Aprenda a integrar uma API de verificação de e-mail para lidar com resultados entregáveis, não entregáveis e catch-all indeterminados em seus fluxos.
Integre a API de Verificação de entregabilidade de e-mail para distinguir endereços entregáveis e não entregáveis de domínios catch-all indeterminados em fluxos de trabalho síncronos e em lote.
O EmailCheckPro fornece uma API de verificação de entregabilidade de e-mail que determina se um endereço é entregável (capaz de receber e-mail) ou não entregável no momento da verificação. Um veredito de entregável indica que o endereço pode aceitar mensagens no momento da consulta, enquanto um veredito de não entregável identifica um endereço incapaz de receber e-mail. O serviço avalia endereços em praticamente qualquer domínio sem enviar mensagens aos destinatários. Ao integrar fluxos de trabalho de API em tempo real e em lote, as equipes de engenharia podem separar endereços de destinatários ativos de registros não entregáveis e domínios catch-all indeterminados, melhorando a qualidade da transmissão e mantendo a higiene dos dados em sistemas de ingestão.
Vereditos principais de entregabilidade e escopo operacional
Avaliar endereços de destinatários requer distinções claras entre resultados entregáveis, não entregáveis e indeterminados.
Um veredito de entregável confirma que o endereço do destinatário estava acessível e preparado para receber e-mail quando verificado. Por outro lado, um resultado não entregável indica que o endereço é incapaz de receber mensagens. Ambos os vereditos representam resultados de verificação concluídos.
As avaliações de entregabilidade fornecem sinais de acessibilidade pontuais, e não garantias persistentes. As equipes de desenvolvimento usam esses sinais para remover endereços inativos das filas de comunicação, ajudando a proteger o desempenho da infraestrutura enquanto respeitam os princípios europeus de minimização de dados sob o GDPR Article 5 (Regulation (EU) 2016/679).
Integração síncrona para verificações únicas e em lote
Aplicações que capturam dados de contato no cadastro ou em atualizações de perfil exigem uma avaliação rápida e síncrona. O EmailCheckPro fornece dois endpoints dedicados em tempo real para fluxos de trabalho interativos.
Para envios individuais, os desenvolvedores consultam POST /api/v1/check com um único endereço completo.
Ao lidar com pequenos lotes de entradas de usuários, POST /api/v1/batch-check processa de 1 a 100 endereços de forma síncrona dentro de uma única solicitação HTTP. A resposta de verificação múltipla mantém a sequência exata da lista de entrada. Cada registro inclui uma propriedade exists ao lado dos detalhes da verificação. Nesse esquema, exists=false indica que o serviço não gerou um resultado concluído para aquela entrada, em vez de um veredito de não entregável. Essa distinção permite que os sistemas de ingestão tentem novamente problemas transitórios enquanto filtram com segurança as entradas confirmadas como não entregáveis.
Tarefas em lote assíncronas para processamento de listas
Manter grandes arquivos de banco de dados requer uma arquitetura de processamento assíncrona. Ao auditar bases de contatos, os sistemas enviam trabalhos de verificação via POST /api/v1/bulk-tasks.
Os envios em lote aceitam arquivos TXT ou CSV estruturados contendo um endereço de e-mail completo por linha. Durante a ingestão do arquivo, a plataforma remove automaticamente linhas duplicadas e entradas malformadas, preparando uma tarefa limpa. Limites de contagem documentados se aplicam por produto; as equipes devem revisar a documentação oficial para os limites atuais de tarefas.
Como os trabalhos em lote são executados de forma assíncrona, as aplicações monitoram o progresso usando GET /api/v1/bulk-tasks/{id}. Os fluxos de trabalho do cliente devem consultar este endpoint com uma frequência não superior a uma vez a cada 30 segundos. Assim que o processamento é concluído, o endpoint fornece um result_url que aponta para um arquivo CSV contendo cada identificador e seu resultado ativado. O link de download gerado permanece válido por 12 horas e é atualizado sempre que o status da tarefa é consultado novamente.
Lidando com catch-alls indeterminados e exceções de formatação
Pipelines de qualidade de dados confiáveis devem diferenciar falhas explícitas de entregabilidade de entradas ambíguas ou malformadas.
Sob o RFC 5322: Internet Message Format, um endereço de e-mail consiste em uma parte local e um domínio unidos por um símbolo @. Se uma entrada recebida não tiver essa estrutura, a API trata o payload como um formato inválido. Um formato inválido permanece distinto de um veredito de não entregável, representando uma falha de sintaxe estrutural.
Servidores de e-mail catch-all apresentam outra categoria operacional. Esses domínios aceitam mensagens endereçadas a qualquer nome de usuário local arbitrário, impedindo que o mecanismo de verificação isole definitivamente caixas de entrada válidas. Em vez de adivinhar, o EmailCheckPro marca as configurações catch-all como indeterminadas. Na verificação em tempo real, domínios catch-all retornam o código de status 42200 sem um resultado concluído. Verificações indeterminadas, inválidas e com falha não geram cobranças, permitindo que as equipes encaminhem registros catch-all para filas de revisão separadas.
Perguntas frequentes
O que distingue um veredito de não entregável de um resultado indeterminado?
As verificações em tempo real para domínios catch-all retornam o código de status 42200 sem um veredito concluído, deixando esses endereços sem cobrança e disponíveis para políticas de revisão separadas.
Como as solicitações de API de verificação múltipla diferem das tarefas em lote assíncronas?
As chamadas de verificação múltipla usam POST /api/v1/batch-check para validar de 1 a 100 endereços de forma síncrona, retornando resultados diretamente na resposta HTTP enquanto preservam a ordem de entrada. As tarefas em lote assíncronas usam POST /api/v1/bulk-tasks para processar grandes listas TXT ou CSV. As tarefas em lote são executadas offline, exigem a consulta de GET /api/v1/bulk-tasks/{id} em intervalos de 30 segundos e geram um CSV para download via result_url válido por 12 horas.
Saiba mais
Escolha as informações do produto que se adequam à próxima etapa do seu fluxo de trabalho.