API результатів

Отримання результатів сканування

Повертає окремі результати перевірок для завершеного сканування.

GET /scans/{scanId}/results

Параметри запиту

Параметр	Тип	Опис
page	integer	Номер сторінки (за замовчуванням: 1)
limit	integer	Результатів на сторінку (за замовчуванням: 50, макс: 200)
result	string	Фільтр: passed, failed, skipped
severity	string	Фільтр: critical, high, medium, low
framework	string	Фільтр за фреймворком: 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	Фреймворк, що визначає цю перевірку (cis, eidsca, cisa, nis2)
help_url	string	Посилання на офіційну документацію або еталон
remediation_steps	string	Покрокові інструкції з виправлення
source_tool	string	Тип механізму сканування (compliance)
raw_output	object	Необроблений вивід оцінювання (може бути null для деяких перевірок)