Referência da API/Endpoints
Sessões de Utilizador
GET /sessions
Lista o histórico de sessões (login/logout/MFA) do tenant.
Autenticação: esta rota não usa API Key, exige sessão de browser autenticada com role ADMIN, SUPER_ADMIN ou AUDITOR.
Query params:
| Param | Tipo | Descrição | |||
|---|---|---|---|---|---|
userId |
string | Filtrar por utilizador | |||
action |
string | LOGIN |
LOGOUT |
MFA_VERIFY |
SESSION_EXPIRED |
success |
string | "true" |
"false" |
||
from |
ISO 8601 | Data de início | |||
to |
ISO 8601 | Data de fim | |||
limit |
int | Máximo de resultados (default 100, máx. 500) | |||
cursor |
string | Paginação por cursor (id do último registo) |
Resposta:
{
"data": [
{
"id": "sl_abc123",
"action": "LOGIN",
"ipAddress": "203.0.113.10",
"userAgent": "Mozilla/5.0 (Windows NT 10.0) Chrome/126",
"deviceName": "Windows · Chrome",
"success": true,
"failureReason": null,
"createdAt": "2026-06-30T08:15:00Z",
"user": { "id": "usr_xyz", "name": "João Silva", "email": "joao@empresa.pt" }
}
],
"meta": { "total": 1, "hasMore": false, "nextCursor": null }
}
Nota:
meta.totalreflete o número de registos nesta página (tamanho da página devolvida), não o total absoluto de sessões do tenant. Para paginar, usarhasMore+nextCursor.
Em breveEsta página estará disponível em breve.