API Αποτελεσμάτων

Maintained by: Aether365 Team Audience: Developers Scope: Results API endpoints - retrieving scan findings

Ανάκτηση Αποτελεσμάτων Σάρωσης

Επιστρέφει τα μεμονωμένα αποτελέσματα ελέγχων για μια ολοκληρωμένη σάρωση.

GET /scans/{scanId}/results

Παράμετροι Ερωτήματος

Παράμετρος	Τύπος	Περιγραφή
page	integer	Αριθμός σελίδας (προεπιλογή: 1)
limit	integer	Αποτελέσματα ανά σελίδα (προεπιλογή: 50, μέγιστο: 200)
result	string	Φίλτρο: passed, failed, skipped
severity	string	Φίλτρο: critical, high, medium, low
framework	string	Φίλτρο framework: cis, eidsca, cisa, nis2

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

---

Ανάκτηση Μεμονωμένου Αποτελέσματος

Επιστρέφει τις λεπτομέρειες ενός μεμονωμένου αποτελέσματος ελέγχου.

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

Παράδειγμα Αιτήματος

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

Παράδειγμα Απάντησης

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

Αναφορά Πεδίων

Πεδίο	Τύπος	Περιγραφή
test_id	string	Μοναδικό αναγνωριστικό ελέγχου (π.χ. CIS.M365.1.1.1)
title	string	Ονομα ελέγχου σε απλή γλώσσα
result	string	passed, failed ή skipped
severity	string	critical, high, medium ή low
framework	string	Framework που ορίζει τον έλεγχο (cis, eidsca, cisa, nis2)
help_url	string	Σύνδεσμος στην επίσημη τεκμηρίωση ή αναφορά benchmark
remediation_steps	string	Οδηγίες διόρθωσης βήμα προς βήμα
source_tool	string	Τύπος μηχανής σάρωσης (compliance ή exposure)
raw_output	object	Ακατέργαστη έξοδος αξιολόγησης (μπορεί να είναι null)