Rezultatų API

Autorius: Aether365 komanda Auditorija: Kūrėjai Apimtis: Rezultatų API galutiniai taškai - nuskaitymo radinių gavimas

Nuskaitymo rezultatų gavimas

Grąžina individualius patikrinimų rezultatus užbaigtam nuskaitymui.

GET /scans/{scanId}/results

Užklausos parametrai

Parametras	Tipas	Aprašymas
page	integer	Puslapio numeris (numatytasis: 1)
limit	integer	Rezultatų skaičius puslapyje (numatytasis: 50, maks.: 200)
result	string	Filtras: passed, failed, skipped
severity	string	Filtras: critical, high, medium, low
framework	string	Filtruoti pagal sistemą: cis, eidsca, cisa, nis2

Užklausos pavyzdys

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

Atsakymo pavyzdys

{
  "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
  }
}

---

Vieno rezultato gavimas

Grąžina vieno individualaus patikrinimo rezultato detales.

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

Užklausos pavyzdys

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

Atsakymo pavyzdys

{
  "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"
  }
}

Laukų nuoroda

Laukas	Tipas	Aprašymas
test_id	string	Unikalus patikrinimo identifikatorius (pvz., CIS.M365.1.1.1)
title	string	Žmogui suprantamas patikrinimo pavadinimas
result	string	passed, failed arba skipped
severity	string	critical, high, medium arba low
framework	string	Sistema, apibrėžianti šį patikrinimą (cis, eidsca, cisa, nis2)
help_url	string	Nuoroda į oficialią dokumentaciją ar lyginamojo standarto nuorodą
remediation_steps	string	Nuoseklios ištaisymo instrukcijos
source_tool	string	Nuskaitymo variklio tipas (compliance arba exposure)
raw_output	object	Neapdorotas vertinimo rezultatas (gali būti null kai kuriems patikrinimams)