Skip to main content
GET
Ranking Global

Descrição

Obtém o ranking global dos top 100 leitores com maior streak de leitura. Esta rota é pública e não requer autenticação. O ranking é atualizado automaticamente e utiliza cache otimizado que expira todos os dias às 5h da manhã (horário de Brasília).

Características

  • Cache Inteligente: TTL dinâmico que expira às 5h (horário de Brasília)
  • Top 100: Retorna apenas os 100 melhores leitores
  • Emails Mascarados: Emails parcialmente ocultos para privacidade
  • Filtro de Atividade: Apenas leitores ativos nos últimos 7 dias
  • Performance Otimizada: Query com índices e JOINs otimizados

Response

Response Format

Exemplo de Uso

Request

Response

Notas de Implementação

Cache Strategy

  • O cache é invalidado automaticamente às 5h da manhã (horário de Brasília)
  • TTL dinâmico calculado para expirar no próximo horário de renovação
  • Máximo de 24 horas de cache como failsafe

Filtros Aplicados

  • Apenas streaks ativos (currentStreak > 0)
  • Leitores com atividade nos últimos 7 dias
  • Ordenação por streak atual, depois por streak máximo

Privacidade

  • Emails são mascarados mantendo apenas os 2 primeiros caracteres do nome de usuário
  • Display names buscados do banco de autenticação
  • Fallback para “Leitor Anônimo” quando display name não disponível

Response

200 - application/json

Ranking global obtido com sucesso

success
boolean
data
object