Invalidar Cache do Ranking

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

const response = await fetch('https://backend.testeswaffle.org/streaks/ranking/global/invalidate-cache', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SEU_JWT_TOKEN_ADMIN'
  }
});
const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer SEU_JWT_TOKEN_ADMIN'
}

response = requests.post(
    'https://backend.testeswaffle.org/streaks/ranking/global/invalidate-cache',
    headers=headers
)
data = response.json()
print(data)

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

{
  "success": false,
  "message": "Erro ao invalidar cache do ranking",
  "error": "Detalhes do erro específico"
}

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'

const response = await fetch('https://backend.testeswaffle.org/streaks/ranking/global/invalidate-cache', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SEU_JWT_TOKEN_ADMIN'
  }
});
const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer SEU_JWT_TOKEN_ADMIN'
}

response = requests.post(
    'https://backend.testeswaffle.org/streaks/ranking/global/invalidate-cache',
    headers=headers
)
data = response.json()
print(data)

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

{
  "success": false,
  "message": "Erro ao invalidar cache do ranking",
  "error": "Detalhes do erro específico"
}

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'

const response = await fetch('https://backend.testeswaffle.org/streaks/ranking/global/invalidate-cache', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer SEU_JWT_TOKEN_ADMIN'
  }
});
const data = await response.json();
console.log(data);

import requests

headers = {
    'Authorization': 'Bearer SEU_JWT_TOKEN_ADMIN'
}

response = requests.post(
    'https://backend.testeswaffle.org/streaks/ranking/global/invalidate-cache',
    headers=headers
)
data = response.json()
print(data)

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

{
  "success": false,
  "message": "Erro ao invalidar cache do ranking",
  "error": "Detalhes do erro específico"
}

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

Ranking de Leitores (Legacy)Criar Grupo de Amigos

API documentation

Referrals API

Streaks API

Subscription API

SAC/Support API

Quiz API

OpenAI API

Invalidar Cache do Ranking

Descrição

Autenticação

Uso Recomendado

Response

Efeitos da Invalidação

Imediatos

Subsequentes

Monitoramento

Logs

Métricas

Considerações de Performance

Impacto Estimado

Alternativas

Authorizations

Response

​Descrição

​Autenticação

​Uso Recomendado

​Response

​Efeitos da Invalidação

​Imediatos

​Subsequentes

​Monitoramento

​Logs

​Métricas

​Considerações de Performance

​Impacto Estimado

​Alternativas

Authorizations

Response

Descrição

Autenticação

Uso Recomendado

Response

Efeitos da Invalidação

Imediatos

Subsequentes

Monitoramento

Logs

Métricas

Considerações de Performance

Impacto Estimado

Alternativas