Skip to main content
GET

Descrição

Lista todos os grupos de amigos dos quais o usuário autenticado é membro. Retorna informações detalhadas sobre cada grupo, incluindo contagem de membros e status de proprietário.

Autenticação

Esta rota requer autenticação JWT. Retorna apenas grupos onde o usuário é membro ativo.

Response

success
boolean
Indica se a operação foi bem-sucedida
data
object

Características

Ordenação

  • Grupos ordenados por updatedAt decrescente
  • Grupos com atividade recente aparecem primeiro
  • Grupos criados recentemente têm prioridade

Informações Incluídas

Status do Usuário

  • isOwner: Indica se pode gerenciar o grupo
  • joinedAt: Quando o usuário entrou no grupo
  • Diferencia entre grupos próprios e grupos onde foi convidado

Métricas do Grupo

  • memberCount: Calculado em tempo real
  • maxMembers: Limite configurado pelo dono
  • isPublic: Visibilidade do grupo

Filtros Aplicados

  • Apenas grupos onde isActive = 1 (membro ativo)
  • Usuário deve estar presente na tabela friendGroupMembers
  • Grupos deletados ou arquivados não aparecem

Casos de Uso

Dashboard de Grupos

Verificar Limites

Estatísticas

Performance

Otimizações

  • Query com JOIN otimizado
  • Contagem de membros em lote
  • Índices em memberEmail e groupId

Límites

  • Não há limite de grupos por usuário
  • Response típico: 5-15 grupos por usuário
  • Tempo de resposta: ~100-300ms

Próximas Ações

Com a lista de grupos, você pode:
  1. Ver ranking: GET /streaks/groups/:groupId/ranking
  2. Adicionar membros: POST /streaks/groups/:groupId/members (se for dono)
  3. Gerenciar grupo: Operações baseadas em isOwner

Authorizations

Authorization
string
header
required

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

Response

200 - application/json

Lista de grupos obtida com sucesso

success
boolean
data
object