Referência da API/Endpoints
Issues
GET /issues
Vista agregada, só de leitura, de issues abertas do tenant, reúne 6 fontes num único feed. Não existem POST/PUT/DELETE neste endpoint: o tratamento de cada item faz-se sempre no módulo de origem (Gaps, Incidentes, etc.), nunca por aqui.
Autenticação: sessão de browser ou x-api-key, este endpoint aceita ambos, ao contrário da maioria dos endpoints desta secção que só aceitam x-api-key.
Query params:
| Param | Tipo | Descrição | |||||
|---|---|---|---|---|---|---|---|
source |
string | Filtra por fonte: GAP |
INTEGRATION_FINDING |
AUDIT_FINDING |
CAPA |
CONTROL_TEST |
INCIDENT |
severity |
string | Filtra por severidade normalizada: LOW |
MEDIUM |
HIGH |
CRITICAL |
||
entityId |
string | Filtra por entidade, só se aplica às fontes GAP, CONTROL_TEST e INCIDENT (as restantes não têm entityId no schema) |
|||||
limit |
int | Nº máx. de itens por fonte (default 100, máx. 500), não é um limite global sobre data |
Resposta:
{
"data": [
{
"source": "GAP",
"sourceId": "gap_abc123",
"title": "Falta MFA em contas administrativas",
"severity": "CRITICAL",
"status": "OPEN",
"dueDate": null,
"href": "/dashboard/gaps/gap_abc123",
"createdAt": "2026-08-01T09:00:00Z"
},
{
"source": "CONTROL_TEST",
"sourceId": "ct_xyz789",
"title": "Verificação de MFA em contas privilegiadas",
"severity": "HIGH",
"status": "FAIL",
"dueDate": "2026-09-01T00:00:00Z",
"href": "/dashboard/control-tests",
"createdAt": "2026-08-05T06:00:00Z"
}
],
"meta": {
"total": 2,
"counts": {
"total": 47,
"bySource": {
"GAP": 12,
"INTEGRATION_FINDING": 20,
"AUDIT_FINDING": 3,
"CAPA": 5,
"CONTROL_TEST": 4,
"INCIDENT": 3
},
"bySeverity": { "LOW": 8, "MEDIUM": 15, "HIGH": 18, "CRITICAL": 6 }
}
}
}
Notas:
meta.totalreflete o nº de itens devolvidos emdata(sujeito aolimitpor fonte), para os totais reais e sem limitação, usarmeta.counts.totalemeta.counts.bySource, calculados comgroupBy/countdiretos na base de dados.datavem ordenado por severidade desc e, dentro da mesma severidade, porcreatedAtdesc.- Normalização de severidade por fonte:
GAP/INTEGRATION_FINDING(escalaRiskLevel,INFO→LOW),CAPA(escalaPriority, mapeamento 1:1),AUDIT_FINDING(MAJOR→HIGH,MINOR→MEDIUM,OBSERVATION→LOW, sem equivalente aCRITICAL),CONTROL_TEST(sempreHIGH, uma falha de controlo é sempre tratada como severa),INCIDENT(escalaIncidentSeverity, mapeamento 1:1). - Rate limit: 60 req/min por tenant (incluído no grupo de leituras genéricas, ver secção Rate Limits).
Em breveEsta página estará disponível em breve.