Recuperação de conta
Redefina a senha com o e-mail da conta e entre novamente antes de investigar saldo, histórico ou chaves de API.
Suporte
Resolva um problema de conta ou de API do AvatarLookup
Comece pelo código de erro ou pelo fluxo afetado, siga a verificação recomendada e fale com o suporte apenas quando a próxima etapa documentada não resolver.
Redefinir sua senha
Referência de solicitações da API
Confirme o cabeçalho X-API-Key, o identificador enviado, service_type=ws_profile | email_profile, o envelope da resposta e os limites publicados.
Pagamentos e saldo
Compare o saldo creditado, a quantidade de verificações, as formas de pagamento e a regra de reembolso automático antes de abrir uma solicitação sobre pagamento.
Guia de erros
O que fazer em cada erro da API?
Use o status HTTP e o código da resposta em conjunto. Remova dados sigilosos antes de compartilhar uma resposta com o suporte.
| Status / código | Significado | Próxima ação |
|---|---|---|
| 401 / 40100 | A chave de API está ausente ou é inválida. | Envie X-API-Key, confirme que copiou a chave ativa e crie uma substituta em Configurações se a original não estiver disponível. |
| 402 / 40200 | A conta não tem saldo suficiente para uma consulta de foto de perfil. | Verifique o preço atual e o saldo e conclua uma recarga antes de repetir a mesma solicitação. |
| 429 / 42901 | Todas as cinco vagas de solicitações simultâneas da conta estão ocupadas ou já há uma verificação múltipla em execução nesta conta. | Aguarde os segundos de Retry-After e tente novamente quando uma solicitação em andamento terminar. A solicitação rejeitada não é cobrada. |
| 503 / 50303 | A plataforma tem verificações demais em andamento neste momento. | Aguarde os segundos de Retry-After e reenvie a mesma solicitação. Nada foi cobrado. |
| 400 / 40000 | Um arquivo de tarefa em massa foi recusado no envio (grande demais, vazio, formato incorreto, menos linhas que o mínimo ou nenhum país selecionado), ou a tarefa falhou durante a preparação do arquivo: poucas entradas válidas após remover linhas duplicadas e inválidas, entradas demais para uma única tarefa ou números de outros países. | Se o envio foi recusado, nada foi cobrado: corrija o arquivo conforme descrito no erro e envie novamente. Se a tarefa foi aceita e depois falhou durante a preparação do arquivo, ela nunca chegou ao serviço de verificação e o valor reservado foi reembolsado integralmente; os detalhes da tarefa informam o motivo. |
| 409 / 40901 | A tarefa ainda não terminou ou o link do resultado ainda não está disponível. | Aguarde a tarefa chegar a success antes de buscar o resultado. O estado atual aparece na página de verificação em massa. |
| 504 / 50400 | A verificação não terminou dentro do tempo limite (60s para única, 300s para lote). | Repita a mesma solicitação; ela não foi cobrada. Um lote com tempo esgotado é reembolsado integralmente, então reenvie a lista inteira. |
| 503 / 50300 | O serviço de validação está temporariamente indisponível ou em manutenção. | Não considere que a conta não tem foto de perfil. Tente novamente mais tarde; consultas com falha ou indeterminadas não mantêm a cobrança. |
Antes de falar com o suporte
Inclua os detalhes que identificam a solicitação
Um contexto útil reduz o tempo de investigação sem exigir senhas ou valores de chaves de API.
- ContaO e-mail associado ao espaço de trabalho.
- SolicitaçãoO ID da transação, o tipo de serviço e o horário aproximado da solicitação.
- RespostaO código e a mensagem de erro da API, sem dados sigilosos.
Checklist para um suporte mais rápido
A maioria dos problemas de conta e de API é resolvida mais rapidamente quando sua mensagem inclui o e-mail da conta, o service_type, o horário da solicitação e o corpo da resposta com dados sigilosos ocultados.
Contato: support@avatarlookup.com