Reportar Estatísticas

Este endpoint permite que seu bot envie periodicamente o número de servidores e usuários em que está presente.

Endpoint

| POST | /api/v1/bots/stats | Sim (Bearer) |

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

Parâmetros do Body (JSON)

Campo	Tipo	Obrigatório	Descrição
botId	String	Sim	O ID do seu bot no Discord.
serverCount	Number	Sim	Quantidade total de servidores.
userCount	Number	Sim	Quantidade total de usuários.
shardCount	Number	Não	Quantidade de shards (padrão 1).

Limites de Taxa (Tier)

O intervalo mínimo aceito entre postagens depende do plano do seu bot:

• Free Tier: 30 minutos
• Premium Tier: 5 minutos
• Business Tier: 1 minuto

Se você enviar requisições mais rápido que o permitido por sua tier, receberá um erro 429 Too Many Requests.

Exemplo de Requisição

curl -X POST https://botgate-api-987684559046.us-central1.run.app/api/v1/bots/stats \
  -H "Authorization: Bearer <SUA_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{
    "botId": "1234567890123456789",
    "serverCount": 4,
    "userCount": 273,
    "shardCount": 1
  }'

Resposta de Sucesso

{
  "success": true,
  "message": "Stats updated successfully",
  "data": {
    "botId": "1234567890123456789",
    "botName": "BotTeste",
    "serverCount": 4,
    "userCount": 273,
    "shardCount": 1,
    "updatedAt": "2026-01-24T04:13:56.771Z"
  }
}

Pacote NPM

Ao usar o método reporter.start(client), este endpoint é chamado automaticamente seguindo o intervalo correto do seu plano. Para forçar um envio manual, use reporter.sendStats().