Pular para o conteúdo principal

Histórico de Estatísticas

Retorna dados históricos de servidores, votos e avaliações do seu bot, formatados especialmente para a criação de gráficos e tabelas de linha do tempo.

Endpoint​

| GET | /api/v1/bots/:botId/stats/history | Sim (Bearer) |

URL Completa: https://botgate-api-987684559046.us-central1.run.app/api/v1/bots/:botId/stats/history

Parâmetros de Query​

ParâmetroTipoPadrãoDescrição
periodStringallPeríodo desejado: daily, weekly, monthly ou all.

Resposta de Sucesso (Exemplo Daily)​

{
  "success": true,
  "data": {
    "botId": "1234567890123456789",
    "botName": "BotTeste",
    "daily": [
      {
        "date": "2026-01-24T03:00:00.000Z",
        "servers": 4,
        "votes": 0,
        "rating": "0.00"
      }
    ],
    "weekly": [
      {
        "week": 202604,
        "weekStart": "2026-01-24T03:00:00.000Z",
        "servers": 4,
        "votes": 0,
        "rating": "0.00"
      }
    ],
    "monthly": [],
    "metadata": {
      "period": "all",
      "dataPoints": {
        "daily": 1,
        "weekly": 1,
        "monthly": 0
      },
      "generatedAt": "2026-01-24T04:42:12.298Z"
    }
  }
}

Limites por Tier​

A quantidade de dias passados que você pode consultar depende do plano do seu bot:

  • Free Tier: 7 dias de histórico.
  • Premium Tier: 90 dias de histórico.
  • Business Tier: 365 dias de histórico.
Agregação de Dados

Os dados retornados são médias diárias/semanais/mensais para garantir gráficos suaves e performance na API.

Casos de Uso​

  • Criar gráficos de crescimento personalizados no dashboard do seu bot.
  • Identificar quedas bruscas de servidores após atualizações específicas.
  • Comparar o desempenho de campanhas de votos entre diferentes meses.
Pacote NPM

Obtenha esses dados formatados para seu bot usando o método reporter.getStatsHistory(botId, period).