Gestão de Condutores

Este módulo é responsável pela administração dos condutores (Direct Users) vinculados à empresa B2B. A API permite o acompanhamento detalhado do comportamento, grupos atribuídos e gastos acumulados.

---

Listar Condutores e LTV

Retorna a lista completa de utilizadores associados à empresa autenticada.

O destaque deste endpoint é o cálculo dinâmico da propriedade total_spent (Life-Time Value), que correlaciona o identificador do condutor com o histórico global de recargas faturadas no Core System.

Método: GET
Rota: /users
Autenticação: Obrigatória (Bearer JWT)

Resposta de Sucesso (200 OK)

Retorna uma coleção paginada de recursos de utilizador.

{
  "data": [
    {
      "id": 1,
      "email": "condutor@exemplo.com",
      "status": "active",
      "total_spent": 15050, 
      "last_charge": "2026-03-15T14:30:00Z",
      "tags": ["Premium", "Frota-A"],
      "groups": ["VIP"]
    }
  ]
}