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.
| Code | Meaning | Description |
|---|---|---|
| 200 | OK | Requisição bem-sucedida, resultados retornados |
| 201 | Created | Recurso criado (por exemplo, busca em massa iniciada) |
| 202 | Accepted | Requisição aceita, processamento assíncrono |
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.
| Code | Meaning | Description |
|---|---|---|
| 400 | Bad Request | Parâmetros inválidos ou ausentes |
| 401 | Unauthorized | Chave de API inválida ou ausente |
| 402 | Payment Required | Créditos insuficientes |
| 429 | Too Many Requests | Limite de taxa excedido |
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.
| Code | Meaning | Description |
|---|---|---|
| 500 | Internal Server Error | Algo deu errado do nosso lado |
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:
| Qualification | Meaning |
|---|---|
valid | E-mail encontrado e verificado |
invalid | E-mail não encontrado |
ongoing | Busca ainda em andamento |
Quais qualificações o Email Verifier retorna?
O Email Verifier retorna um dos seguintes valores no campoqualification:
| Qualification | Meaning |
|---|---|
valid | E-mail é válido e entregável |
invalid | E-mail é inválido ou não entregável |
ongoing | Verificação ainda em andamento |
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:
| Qualification | Meaning |
|---|---|
found | Número de telefone localizado com sucesso |
not_found | Número de telefone não pôde ser encontrado |
ongoing | Busca ainda em andamento |
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.
| Status | Meaning |
|---|---|
ongoing | O lote ainda está sendo processado |
completed | Todas as buscas do lote foram concluídas |
failed | O lote falhou |
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.