Headers HTTP e suporte a CORS na API Ghosting

A API pública do Ghosting envia cabeçalhos pré-configurados para consumo universal em navegadores, servidores e clientes móveis. Essa configuração permite que qualquer front-end faça requisições sem proxy intermediário, e que a resposta seja armazenada em cache no edge da CDN.

Headers padrão

Header	Valor padrão	Descrição
`Access-Control-Allow-Origin`	`*`	Aceita requisições vindas de qualquer domínio ou front-end (CORS totalmente aberto).
`Access-Control-Allow-Methods`	`GET, OPTIONS`	Métodos HTTP permitidos para a API pública.
`Content-Type`	`application/json; charset=utf-8`	Todas as respostas são retornadas em formato JSON UTF-8.
`Cache-Control`	`public, s-maxage=30, stale-while-revalidate=60`	Cache de borda de 30 segundos, com 60 segundos de tolerância para revalidação.

CORS aberto

Como o Access-Control-Allow-Origin é *, você pode chamar a API diretamente de um fetch no navegador sem configurar proxy CORS:

// Funciona em qualquer origem, inclusive localhost
const res = await fetch("https://ghosting.fun/api/v1/users/ghosting");
const { data } = await res.json();

Como a API não exige credenciais, o header Access-Control-Allow-Credentials não é enviado. Não use credentials: "include" nas requisições fetch.

Estratégia de cache

O header Cache-Control: public, s-maxage=30, stale-while-revalidate=60 significa:

s-maxage=30: proxies e CDNs podem servir a resposta em cache por até 30 segundos.
stale-while-revalidate=60: por até 60 segundos após a expiração, a CDN pode servir a versão em cache enquanto revalida em segundo plano.

Na prática, requisições repetidas ao mesmo perfil retornam quase instantaneamente. Perfis com mudanças raras (badges, decoração de avatar) permanecem consistentes por até 90 segundos.

Se sua aplicação precisa de dados sempre atualizados (por exemplo, contagem de views em tempo real), considere um cache local adicional com TTL curto para reduzir latência sem exceder a frequência natural de atualização.

Métodos suportados

Apenas GET e OPTIONS são aceitos. Chamadas POST, PUT, PATCH ou DELETE retornam erro, já que a API pública é somente-leitura.

Introdução

Conceitos

Referência de API

Schemas

Guias

Headers HTTP e suporte a CORS na API Ghosting

Headers padrão

CORS aberto

Estratégia de cache

Métodos suportados

Próximos passos

Autenticação

Consultar perfil

​Headers padrão

​CORS aberto

​Estratégia de cache

​Métodos suportados

​Próximos passos

Autenticação

Consultar perfil

Headers padrão

CORS aberto

Estratégia de cache

Métodos suportados

Próximos passos