API de Resultados

Obter Resultados de uma Análise

Devolve os resultados individuais de verificação para uma análise concluída.

GET /scans/{scanId}/results

Parâmetros de Consulta

Parâmetro	Tipo	Descrição
page	integer	Número da página (predefinido: 1)
limit	integer	Resultados por página (predefinido: 50, máximo: 200)
result	string	Filtrar: passed, failed, skipped
severity	string	Filtrar: crítical, high, medium, low
framework	string	Filtrar por framework: cis, eidsca, cisa, nis2

Exemplo de Pedido

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

Exemplo de Resposta

{
  "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": "crítical",
      "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
  }
}

---

Obter Resultado Individual

Devolve o detalhe de um resultado de verificação individual.

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

Exemplo de Pedido

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

Exemplo de Resposta

{
  "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": "crítical",
    "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"
  }
}

Referência de Campos

Campo	Tipo	Descrição
test_id	string	Identificador único da verificação (ex.: CIS.M365.1.1.1)
title	string	Nome legível da verificação
result	string	passed, failed ou skipped
severity	string	crítical, high, medium ou low
framework	string	Framework que define está verificação (cis, eidsca, cisa, nis2)
help_url	string	Ligação para a documentação oficial ou referência do benchmark
remediation_steps	string	Instruções de correção passo a passo
source_tool	string	Tipo de motor de análise (compliance ou exposure)
raw_output	object	Resultado bruto da avaliação (pode ser nulo para algumas verificações)