Skip to main content
POST
/
streaks
/
ranking
/
global
/
invalidate-cache
curl --request POST \
  --url 'https://backend.testeswaffle.org/streaks/ranking/global/invalidate-cache' \
  --header 'Authorization: Bearer SEU_JWT_TOKEN_ADMIN'

{
  "success": true,
  "message": "Cache do ranking global invalidado com sucesso"
}

​
Descrição

Invalida forçosamente o cache do ranking global. Esta é uma rota administrativa que permite forçar a regeneração do ranking em casos especiais, como após correções de dados ou atualizações importantes.

​
Autenticação

Esta rota requer autenticação JWT e é destinada apenas para uso administrativo. Apenas usuários com permissões adequadas devem ter acesso.

​
Uso Recomendado

Esta rota deve ser usada em situações específicas:
  • Após correções manuais de streaks no banco de dados
  • Após migrações ou atualizações de dados
  • Quando detectadas inconsistências no ranking
  • Para testes e validações em ambiente de desenvolvimento
O cache do ranking é renovado automaticamente às 5h da manhã todos os dias. Use esta rota apenas quando necessário.

​
Response

​
success
boolean
Indica se a invalidação foi bem-sucedida
​
message
string
Mensagem descritiva sobre o resultado da operação
curl --request POST \
  --url 'https://backend.testeswaffle.org/streaks/ranking/global/invalidate-cache' \
  --header 'Authorization: Bearer SEU_JWT_TOKEN_ADMIN'

{
  "success": true,
  "message": "Cache do ranking global invalidado com sucesso"
}

​
Efeitos da Invalidação

​
Imediatos

  • Cache do ranking global é removido do KV storage
  • Próxima requisição ao ranking irá regenerar os dados do banco
  • Tempo de resposta será maior na primeira consulta após invalidação

​
Subsequentes

  • Novo cache será criado com TTL até as próximas 5h da manhã
  • Performance normal restaurada após primeira regeneração
  • Todos os endpoints de ranking utilizarão os novos dados

​
Monitoramento

​
Logs

A invalidação de cache é registrada nos logs do sistema: 
[StreakRankingHandler] Cache invalidado manualmente às [timestamp]

​
Métricas

  • Tempo de regeneração do cache
  • Número de registros processados
  • Performance das queries de ranking

​
Considerações de Performance

Evite invalidar o cache durante horários de pico (7h-9h e 18h-20h) pois a regeneração pode causar latência temporária.

​
Impacto Estimado

  • Regeneração: 2-5 segundos para processar ~100k leitores
  • Cache miss: Primeira consulta pode levar 3-8 segundos
  • Recuperação: Performance normal em ~10 segundos

​
Alternativas

Em vez de invalidar o cache, considere:
  • Aguardar a renovação automática às 5h
  • Usar endpoints de debug para investigar problemas
  • Aplicar correções de dados em horários de baixo tráfego

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Response

200 - application/json

Cache invalidado com sucesso

​
success
boolean
​
message
string