Results API

Onderhouden door: Aether365 Team Doelgroep: Ontwikkelaars Scope: Results API endpoints - scanbevindingen ophalen

Scanresultaten ophalen

Retourneert de individuele controleresultaten voor een voltooide scan.

GET /scans/{scanId}/results

Queryparameters

Parameter	Type	Beschrijving
page	integer	Paginanummer (standaard: 1)
limit	integer	Resultaten per pagina (standaard: 50, max: 200)
result	string	Filter: passed, failed, skipped
severity	string	Filter: critical, high, medium, low
framework	string	Filter op framework: cis, eidsca, cisa, nis2

Voorbeeldverzoek

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

Voorbeeldresponse

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

---

Enkel resultaat ophalen

Retourneert het detail van een individueel controleresultaat.

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

Voorbeeldverzoek

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

Voorbeeldresponse

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

Veldreferentie

Veld	Type	Beschrijving
test_id	string	Unieke controle-identificatie (bijv. CIS.M365.1.1.1)
title	string	Begrijpelijke naam van de controle
result	string	passed, failed of skipped
severity	string	critical, high, medium of low
framework	string	Framework dat deze controle definieert (cis, eidsca, cisa, nis2)
help_url	string	Link naar officiele documentatie of benchmarkreferentie
remediation_steps	string	Stapsgewijze herstelinstructies
source_tool	string	Type scan-engine (compliance of exposure)
raw_output	object	Ruwe evaluatie-uitvoer (kan null zijn voor sommige controles)