API výsledkov

Získanie výsledkov skenu

Vráti jednotlivé výsledky kontrol pre dokončený sken.

GET /scans/{scanId}/results

Parametre dopytu

Parameter	Typ	Popis
page	integer	Číslo stránky (predvolené: 1)
limit	integer	Výsledkov na stránku (predvolené: 50, max: 200)
result	string	Filter: passed, failed, skipped
severity	string	Filter: critical, high, medium, low
framework	string	Filtrovať podľa rámca: cis, eidsca, cisa, nis2

Príklad požiadavky

curl "https://api.aether365.io/scans/scan_abc123/results?result=failed&severity=critical" \
  -H "Authorization: Bearer <token>"

Príklad odpovede

{
  "success": true,
  "data": [
    {
      "id": "result_001",
      "scan_id": "scan_abc123",
      "test_id": "CIS.M365.1.1.1",
      "title": "Ensure multifactor authentication is enabled for all users in administrative roles",
      "result": "failed",
      "severity": "critical",
      "framework": "cis",
      "help_url": "https://www.cisecurity.org/benchmark/microsoft_365",
      "remediation_steps": "1. Sign in to the Azure portal...",
      "source_tool": "compliance"
    }
  ],
  "meta": {
    "total": 12,
    "page": 1,
    "limit": 50
  }
}

---

Získanie jedného výsledku

Vráti detail jedného výsledku kontroly.

GET /scans/{scanId}/results/{testId}

Príklad požiadavky

curl https://api.aether365.io/scans/scan_abc123/results/CIS.M365.1.1.1 \
  -H "Authorization: Bearer <token>"

Príklad odpovede

{
  "success": true,
  "data": {
    "id": "result_001",
    "scan_id": "scan_abc123",
    "test_id": "CIS.M365.1.1.1",
    "title": "Ensure multifactor authentication is enabled for all users in administrative roles",
    "result": "failed",
    "severity": "critical",
    "framework": "cis",
    "help_url": "https://www.cisecurity.org/benchmark/microsoft_365",
    "remediation_steps": "1. Sign in to the Azure portal as a Global Administrator.\n2. Navigate to Microsoft Entra ID > Security > Conditional Access.\n3. Create or update a policy requiring MFA for all administrator roles.",
    "raw_output": {},
    "source_tool": "compliance"
  }
}

Referencia polí

Pole	Typ	Popis
test_id	string	Jedinečný identifikátor kontroly (napr. CIS.M365.1.1.1)
title	string	Názov kontroly čitateľný človekom
result	string	passed, failed alebo skipped
severity	string	critical, high, medium alebo low
framework	string	Rámec definujúci túto kontrolu (cis, eidsca, cisa, nis2)
help_url	string	Odkaz na oficiálnu dokumentáciu alebo referenciu štandardu
remediation_steps	string	Podrobné pokyny na opravu
source_tool	string	Typ skenovacieho nástroja (compliance alebo exposure)
raw_output	object	Surový výstup vyhodnotenia (pre niektoré kontroly môže byť null)