# Ghosting API

- [API Pública Ghosting: consulte perfis, badges e criadores](https://docs.ghosting.fun/index.md): API REST pública e gratuita da plataforma Ghosting. Consulte perfis, avatares, decorações, selos de verificação e criadores sem autenticação.
- [Primeiros passos: primeira requisição à API Ghosting](https://docs.ghosting.fun/primeiros-passos.md): Faça sua primeira requisição à API pública Ghosting em menos de um minuto. Consulte um perfil via cURL, JavaScript ou Python sem precisar de autenticação.
- [Autenticação: por que a API Ghosting não exige API key](https://docs.ghosting.fun/conceitos/autenticacao.md): 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.
- [Headers HTTP e suporte a CORS na API Ghosting](https://docs.ghosting.fun/conceitos/cors-headers.md): Consuma a API Ghosting direto do navegador. Referência dos headers padrão de CORS, Content-Type e Cache-Control retornados em todas as respostas.
- [GET /api/v1/users/:username · Consultar perfil](https://docs.ghosting.fun/api-reference/get-user.md): Consulte perfis de usuários na API Ghosting pelo nome de usuário. Retorna dados públicos, badges, redes sociais e informações de status, incluindo contas suspensas.
- [GET /ghosting-api/v1/creators · Listar criadores](https://docs.ghosting.fun/api-reference/list-creators.md): Recupere a lista de criadores ativos na plataforma Ghosting. Perfis deletados, inativos ou banidos são filtrados automaticamente. Cache CDN de 30 segundos.
- [Status codes e erros HTTP da API Ghosting](https://docs.ghosting.fun/api-reference/status-codes.md): Referência completa dos status HTTP e códigos de erro da API Ghosting. Entenda o que cada resposta significa e como tratar falhas em integrações.
- [Schema User: estrutura do objeto de perfil Ghosting](https://docs.ghosting.fun/schemas/user.md): Documentação completa do schema User da API Ghosting. Conheça todos os campos do objeto de perfil, incluindo dados pessoais, selos, redes sociais e informações de moderação.
- [Schema BanInfo: status de moderação do perfil](https://docs.ghosting.fun/schemas/ban-info.md): Documentação do schema BanInfo da API Ghosting. Entenda como a API retorna informações de suspensão via HTTP 200 OK para evitar quebras em bots e integrações.
- [Schema Badges: selos de verificação e cargos](https://docs.ghosting.fun/schemas/badges.md): Documentação do schema Badges da API Ghosting. Conheça os selos de verificação, cargos oficiais e helpers disponíveis nos perfis da plataforma.
- [Schema AvatarDecoration: molduras animadas de perfil](https://docs.ghosting.fun/schemas/avatar-decoration.md): Documentação do schema AvatarDecoration da API Ghosting. Saiba como funcionam as molduras animadas de avatar, hospedadas na CDN Cloudflare R2.
- [Schema Socials: links de redes sociais do perfil](https://docs.ghosting.fun/schemas/socials.md): Documentação do schema Socials da API Ghosting. Conheça as plataformas suportadas e a estrutura dos links de redes sociais vinculados a um perfil.
- [Schema Meta: metadados da resposta da API](https://docs.ghosting.fun/schemas/meta.md): Documentação do schema Meta da API Ghosting. Conheça os metadados presentes em toda resposta da API, incluindo timestamp, versão e tempo de execução.
- [Arquitetura de moderação: 200 OK para perfis suspensos](https://docs.ghosting.fun/guias/moderacao.md): Perfis suspensos na API Ghosting retornam HTTP 200 OK com banInfo detalhado. Entenda o design tolerante a falhas e como tratar suspensões em bots.
- [Exemplos de código: integre a API Ghosting em minutos](https://docs.ghosting.fun/guias/exemplos-codigo.md): Snippets prontos para consultar a API pública Ghosting em cURL, JavaScript, TypeScript, Node.js com Axios e Python. Copie, cole e adapte para seu projeto.
- [Bot Discord: consulte perfis Ghosting com Discord.js v14](https://docs.ghosting.fun/guias/bot-discord.md): Crie um slash command /ghosting no Discord.js v14 que consulta perfis da API Ghosting. Inclui tratamento de perfis ativos, suspensos e não encontrados.

## Optional

- [Discord](https://discord.gg/wWkczsFKRT)
- [GitHub](https://github.com/ihyos)
- [YouTube](https://www.youtube.com/@ghostingoficial)