Autenticação: por que a API Ghosting não exige API key

A API pública Ghosting é 100% aberta e gratuita. Entenda como consultar perfis sem API key, tokens ou JWT, usando apenas o nome de usuário.

A API pública do Ghosting foi projetada para ser consumida sem qualquer tipo de autenticação. Você não precisa criar conta, gerar tokens, configurar OAuth ou registrar aplicativos. Basta enviar uma requisição HTTP GET com o nome de usuário desejado.

Sem headers de autorização

Não envie Authorization: Bearer <token>, X-API-Key ou qualquer variante:

# ✅ Correto
curl "https://ghosting.fun/api/v1/users/ghosting"

# ❌ Desnecessário
curl "https://ghosting.fun/api/v1/users/ghosting" \
  -H "Authorization: Bearer meu_token"

O servidor ignora cabeçalhos de autorização e responde da mesma forma em ambos os casos.

Identificação por username

A identificação de perfis é feita exclusivamente pelo username público (sem o @), passado como parâmetro de rota ou de query:

GET /api/v1/users/ghosting
GET /api/v1/users?username=ghosting

O username não diferencia maiúsculas de minúsculas.

Sem exposição de dados sensíveis

A API foi desenhada para expor apenas dados públicos:

• Não retorna UUIDs internos, e-mails, hashes de senha ou tokens.
• Não permite consultas por ID interno.
• Não expõe metadados administrativos de moderação além do motivo público de suspensão.

Como a API é aberta, ela é ideal para bots, extensões de navegador, widgets, integrações server-side e qualquer aplicação que precise consultar perfis Ghosting sem gerenciar credenciais.

Se sua aplicação faz muitas requisições, aproveite o cache CDN de 30 segundos configurado nas respostas. Veja CORS e Headers para os detalhes de Cache-Control.

Próximos passos

CORS e Headers

Headers padrão retornados pela API.

Consultar perfil

Primeira chamada à API em poucos segundos.