Buscar Votos

Retorna informações detalhadas sobre os votos recebidos pelo seu bot, incluindo histórico recente e contagens por período.

Endpoint

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

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

Parâmetros de Query

Campo	Tipo	Padrão	Descrição
limit	Number	10	Quantidade de últimos votantes a retornar (máx 50).

Resposta de Sucesso

{
  "success": true,
  "data": {
    "botId": "1234567890123456789",
    "botName": "BotTeste",
    "total": 0,
    "monthly": 0,
    "weekly": "0",
    "today": "0",
    "recentVoters": [],
    "monthlyHistory": [],
    "metadata": {
      "recentVotersLimit": 10,
      "recentVotersCount": 0,
      "monthlyHistoryMonths": 0
    }
  }
}

Dica de Integração

Pacote NPM

Você pode buscar os votos diretamente no seu código usando o método reporter.getBotVotes(botId, limit).

Você pode usar este endpoint para recompensar usuários dentro do seu bot que votaram nas últimas 12 horas, verificando a lista de recentVoters.