� Documentação da API

Realiza login e retorna um token JWT para autenticação nas rotas protegidas.

Parâmetros do Body (JSON):

Exemplo de Requisição:

curl -X POST http://localhost:3000/api/auth/login \
  -H "Content-Type: application/json" \
  -d '{
    "username": "admin",
    "password": "admin123"
  }'

Exemplo de Resposta:

{
  "token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...",
  "user": {
    "username": "admin",
    "role": "admin"
  }
}

Retorna estatísticas públicas básicas do bot (não requer autenticação).

Exemplo de Requisição:

curl http://localhost:3000/api/stats/public

Exemplo de Resposta:

{
  "totalUsers": 156,
  "activeUsers": 89,
  "totalSearches": 45231,
  "totalRevenue": 12450.00
}

Lista todos os usuários com suporte a paginação e busca.

Query Parameters:

Exemplo de Requisição:

curl http://localhost:3000/api/users?page=1&limit=20 \
  -H "Authorization: Bearer SEU_TOKEN_JWT"

Retorna detalhes completos de um usuário específico, incluindo histórico de uso e pagamentos.

Exemplo de Requisição:

curl http://localhost:3000/api/users/123456789 \
  -H "Authorization: Bearer SEU_TOKEN_JWT"

Retorna estatísticas de uso diário dos últimos N dias.

Query Parameters:

Exemplo de Requisição:

curl http://localhost:3000/api/usage/daily?days=30

Retorna distribuição de uso por plataforma (Mercado Livre, Amazon, Shopee, etc).

Retorna distribuição de uso por hora do dia (0-23).

Retorna dados de crescimento de usuários (novos cadastros por dia).

Query Parameters:

Retorna estatísticas gerais de pagamentos.

Retorna histórico de receita por mês.