API Σαρώσεων

Maintained by: Aether365 Team Audience: Developers Scope: Scan API endpoints - triggering and listing scans

Λίστα Σαρώσεων

Επιστρέφει σελιδοποιημένη λίστα σαρώσεων για το πιστοποιημένο tenant.

GET /tenants/{tenantId}/scans

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

Παράμετρος	Τύπος	Περιγραφή
page	integer	Αριθμός σελίδας (προεπιλογή: 1)
limit	integer	Αποτελέσματα ανά σελίδα (προεπιλογή: 20, μέγιστο: 100)
status	string	Φίλτρο κατάστασης: in_progress, completed, failed
scan_type	string	Φίλτρο τύπου: compliance, exposure

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

curl https://api.aether365.io/tenants/t_abc123/scans \
  -H "Authorization: Bearer <token>"

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

{
  "success": true,
  "data": [
    {
      "id": "scan_abc123",
      "tenant_id": "t_abc123",
      "scan_type": "compliance",
      "status": "completed",
      "started_at": "2026-04-09T00:00:00Z",
      "completed_at": "2026-04-09T00:14:23Z",
      "pass_count": 87,
      "fail_count": 12,
      "skip_count": 5,
      "score": 87.9
    }
  ],
  "meta": {
    "total": 24,
    "page": 1,
    "limit": 20
  }
}

---

Ανάκτηση Σάρωσης

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

GET /scans/{scanId}

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

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

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

{
  "success": true,
  "data": {
    "id": "scan_abc123",
    "tenant_id": "t_abc123",
    "scan_type": "compliance",
    "status": "completed",
    "started_at": "2026-04-09T00:00:00Z",
    "completed_at": "2026-04-09T00:14:23Z",
    "pass_count": 87,
    "fail_count": 12,
    "skip_count": 5,
    "score": 87.9
  }
}

---

Εκκίνηση Σάρωσης

Ξεκινά μια σάρωση αμέσως για το καθορισμένο tenant.

POST /tenants/{tenantId}/scans

Σώμα Αιτήματος

{
  "scan_type": "compliance"
}

Πεδίο	Τύπος	Υποχρεωτικό	Τιμές
scan_type	string	Ναι	compliance, exposure

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

curl -X POST https://api.aether365.io/tenants/t_abc123/scans \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"scan_type": "compliance"}'

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

{
  "success": true,
  "data": {
    "id": "scan_xyz789",
    "tenant_id": "t_abc123",
    "scan_type": "compliance",
    "status": "in_progress",
    "started_at": "2026-04-09T10:32:00Z",
    "completed_at": null,
    "pass_count": null,
    "fail_count": null,
    "skip_count": null,
    "score": null
  }
}

Σφάλματα

Κωδικός	HTTP	Περιγραφή
SCAN_ALREADY_RUNNING	409	Μια σάρωση αυτού του τύπου εκτελείται ήδη για αυτό το tenant
TENANT_NOT_CONNECTED	400	Η συναίνεση Microsoft δεν ολοκληρώθηκε για αυτό το tenant
SCAN_PLAN_LIMIT_REACHED	429	Η ποσόστωση σαρώσεων εξαντλήθηκε για την τρέχουσα περίοδο χρέωσης