qualification que informa o resultado de uma busca ou verificação. Esta página lista todos os códigos e valores de qualificação para que você possa lidar com as respostas de forma confiável. Para as mensagens de erro correspondentes e os formatos de resposta, consulte Tratamento de erros.
Quais códigos de status HTTP a API retorna?
A API Enrow usa códigos de status HTTP padrão para indicar o resultado de cada requisição. Um código2xx significa que a requisição foi bem-sucedida, um código 4xx aponta um problema com a requisição e um código 5xx significa que algo deu errado do lado da Enrow.
Quais códigos significam sucesso?
Um código de status2xx significa que a API aceitou a requisição. Operações assíncronas (como buscas em massa) retornam 201 ou 202 porque o trabalho continua em segundo plano.
Quais códigos significam que a requisição foi rejeitada?
Um código de status4xx significa que a API rejeitou a requisição por causa de algo que pode ser corrigido do lado do cliente — parâmetros inválidos, uma chave de API ausente ou inválida, créditos insuficientes ou muitas requisições.
Um
401 significa que a chave de API está ausente ou inválida — consulte Autenticação para saber como enviá-la corretamente. Um 402 significa que a conta está sem créditos; revise o consumo em Créditos e cobrança. Um 429 significa que a requisição excedeu a taxa de transferência permitida — consulte Limites de taxa para entender os limites.
A API nunca retorna 404. Um ID de busca desconhecido ou expirado retorna 400 para endpoints em massa e 500 para endpoints individuais.
Quais códigos significam um erro de servidor?
Um código de status5xx significa que a requisição era válida, mas algo deu errado do lado da Enrow. Essas respostas podem ser repetidas com segurança após um breve intervalo.
O que são qualificações de busca?
Uma qualificação de busca é o valor no campoqualification que informa o resultado de uma busca ou verificação. A Enrow retorna esse campo em todos os endpoints, e o resultado é sempre binário — não há “talvez” nem pontuação de probabilidade. Essa é uma escolha de design deliberada.
Por que o resultado é binário?
O resultado é binário porque uma resposta clara de sim ou não é mais fácil de usar do que uma probabilidade. A maioria das ferramentas de enriquecimento retorna um conjunto complexo de categorias — catch-all, arriscado, desconhecido, não verificável, etc. — que obrigam você a criar lógica em torno de probabilidades. A Enrow adotou a abordagem oposta:- A Enrow verifica de forma determinística até mesmo e-mails catch-all, então não há necessidade de uma categoria “catch-all”
- A Enrow não acredita em sistemas probabilísticos com dezenas de classificações — eles adicionam complexidade sem clareza
- Um resultado binário significa que você pode agir sobre os dados imediatamente, sem ficar em dúvida
Quais qualificações o Email Finder retorna?
O Email Finder retorna um dos seguintes valores no campoqualification:
Quais qualificações o Email Verifier retorna?
O Email Verifier retorna um dos seguintes valores no campoqualification:
invalid significa coisas diferentes dependendo do endpoint: no Email Finder, significa que o e-mail não foi encontrado. No Email Verifier, significa que o e-mail existe, mas não é entregável.Quais qualificações o Phone Finder retorna?
O Phone Finder retorna um dos seguintes valores no campoqualification:
Como acompanho uma busca em massa?
Para operações em massa, um campostatus indica o progresso do lote. Faça polling no endpoint GET relevante — resultados em massa do Email Finder, verificações em massa do Email Verifier ou resultados em massa do Phone Finder — até que o status seja completed.
FAQ
Por que estou recebendo um 401 em vez de um 200?
Por que estou recebendo um 401 em vez de um 200?
Um
401 Unauthorized significa que a chave de API está ausente ou inválida. Certifique-se de que cada requisição inclua uma chave válida no cabeçalho x-api-key. Consulte Autenticação para mais detalhes.O que significa um código de status 402?
O que significa um código de status 402?
Um
402 Payment Required significa que a conta não tem créditos suficientes para concluir a requisição. Recarregue ou revise como os créditos são consumidos por endpoint em Créditos e cobrança.Por que um ID de busca desconhecido retorna 400 ou 500 em vez de 404?
Por que um ID de busca desconhecido retorna 400 ou 500 em vez de 404?
A API Enrow nunca retorna
404. Um ID de busca desconhecido ou expirado retorna 400 para endpoints em massa e 500 para endpoints individuais. Verifique novamente o id retornado quando a busca foi iniciada.qualification: ongoing significa que algo falhou?
qualification: ongoing significa que algo falhou?
Não.
ongoing significa que a busca ou verificação ainda está em andamento. Faça polling no endpoint GET novamente após um breve intervalo, ou use um webhook para ser notificado automaticamente quando ela terminar — consulte Como os webhooks funcionam.Próximos passos
Tratamento de erros
Veja as mensagens de erro completas e os formatos de resposta para cada código de status.
Autenticação
Envie sua chave de API no cabeçalho x-api-key para evitar erros 401.
Limites de taxa
Entenda os limites que disparam uma resposta 429.
Créditos e cobrança
Veja como os créditos são consumidos e evite erros 402.