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

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

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

GET /scans/{scanId}/results

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

Параметр	Тип	Опис
page	integer	Номер сторiнки (за замовчуванням: 1)
limit	integer	Результатiв на сторiнку (за замовчуванням: 50, макс: 200)
result	string	Фiльтр: passed, failed, skipped
severity	string	Фiльтр: critical, high, medium, low
framework	string	Фiльтр за фреймворком: cis, eidsca, cisa, nis2

Приклад запиту

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

Приклад вiдповiдi

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

---

Отримання окремого результату

Повертає деталi одного результату перевiрки.

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

Приклад запиту

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

Приклад вiдповiдi

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

Довiдник полiв

Поле	Тип	Опис
test_id	string	Унiкальний iдентифiкатор перевiрки (наприклад, CIS.M365.1.1.1)
title	string	Зрозумiла назва перевiрки
result	string	passed, failed або skipped
severity	string	critical, high, medium або low
framework	string	Фреймворк, що визначає цю перевiрку (cis, eidsca, cisa, nis2)
help_url	string	Посилання на офiцiйну документацiю або еталон
remediation_steps	string	Покроковi iнструкцiї з виправлення
source_tool	string	Тип механiзму сканування (compliance або exposure)
raw_output	object	Необроблений вивiд оцiнювання (може бути null для деяких перевiрок)