Skip to main content
A API Ghosting usa status HTTP padrão para indicar o resultado de cada requisição. Além do código de status, toda resposta de erro inclui um objeto error com código legível por máquina, mensagem descritiva e o status HTTP repetido. Use esta referência para implementar tratamento de erros robusto em clientes, bots e integrações.

​
Status HTTP

​
Códigos de erro

​
string
O parâmetro username está ausente, vazio ou contém caracteres inválidos. Retornado com HTTP 400.
​
string
O usuário solicitado não existe na base de dados. Retornado com HTTP 404.
​
string
Erro inesperado no servidor. Tente novamente mais tarde. Retornado com HTTP 500.

​
Estrutura padrão de erro

Todas as respostas de erro seguem este formato JSON:
Perfis suspensos retornam HTTP 200 OK, não 4xx ou 5xx. A resposta inclui data.status: "suspended" e data.banInfo.isBanned: true. Esse comportamento evita quebras em bots de Discord e outras integrações automatizadas que dependem de sucesso HTTP para continuar o fluxo. Consulte Moderacao para detalhes sobre tratamento de contas suspensas.

​
Dicas de tratamento

Sempre verifique success no corpo da resposta antes de acessar data. Perfis ativos e suspensos retornam success: true, mas apenas perfis ativos têm status: "active".
Para nomes de usuário digitados por usuários finais, normalize removendo o caractere @ antes de enviar à API, já que o parâmetro não o aceita.