API Προγραμματισμένων Σαρώσεων

Maintained by: Aether365 Team Audience: Developers Scope: Scheduled scan API endpoints - creating and managing scan schedules

Οι προγραμματισμένες σαρώσεις ορίζουν επαναλαμβανόμενες εργασίες σάρωσης. Κάθε προγραμματισμένη σάρωση ορίζει ένα επαναλαμβανόμενο trigger που ενεργοποιείται στο ρυθμισμένο διάστημα.

Λίστα Προγραμματισμένων Σαρώσεων

Επιστρέφει όλες τις προγραμματισμένες σαρώσεις για το πιστοποιημένο tenant, συμπεριλαμβανομένης της αυτόματης σάρωσης πλάνου.

GET /tenants/me/scheduled-scans

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

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

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

{
  "success": true,
  "data": [
    {
      "id": "plan",
      "isPlanSchedule": true,
      "name": "Automatic plan scan",
      "frequency": "weekly",
      "hour": 0,
      "minute": 0,
      "dayOfWeek": 0,
      "dayOfMonth": 1,
      "timezone": "UTC",
      "enabled": true,
      "scanType": "compliance",
      "lastTriggeredAt": "2026-04-07T00:00:00Z"
    },
    {
      "id": "sched_abc123",
      "isPlanSchedule": false,
      "name": "Weekly exposure scan",
      "frequency": "weekly",
      "hour": 6,
      "minute": 0,
      "dayOfWeek": 3,
      "dayOfMonth": null,
      "timezone": "Europe/London",
      "enabled": true,
      "scanType": "exposure",
      "lastTriggeredAt": "2026-04-09T06:00:00Z"
    }
  ]
}

Πεδία Απάντησης

Πεδίο	Τύπος	Περιγραφή
id	string	Αναγνωριστικό προγράμματος ("plan" για αυτόματο πρόγραμμα πλάνου)
isPlanSchedule	boolean	true αν είναι η αυτόματη σάρωση πλάνου
name	string	Εμφανιζόμενο όνομα
frequency	string	daily, weekly ή monthly
hour	integer	Ωρα ενεργοποίησης (0-23)
minute	integer	Λεπτό ενεργοποίησης (0-59)
dayOfWeek	integer	Ημέρα εβδομάδας για εβδομαδιαία προγράμματα (0=Δευ, 6=Κυρ)
dayOfMonth	integer	Ημέρα μήνα για μηνιαία προγράμματα (1-31)
timezone	string	Ζώνη ώρας IANA
enabled	boolean	Αν το πρόγραμμα είναι ενεργό
scanType	string	compliance ή exposure
lastTriggeredAt	string ή null	Χρονοσφραγίδα ISO 8601 τελευταίας ενεργοποίησης

---

Δημιουργία Προγραμματισμένης Σάρωσης

Δημιουργεί νέα προγραμματισμένη σάρωση.

POST /tenants/me/scheduled-scans

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

{
  "name": "Monthly exposure scan",
  "frequency": "monthly",
  "hour": 3,
  "minute": 0,
  "dayOfMonth": 1,
  "timezone": "UTC",
  "scanType": "exposure",
  "enabled": true
}

Πεδίο	Τύπος	Υποχρεωτικό	Περιγραφή
name	string	Ναι	Εμφανιζόμενο όνομα
frequency	string	Ναι	daily, weekly ή monthly
hour	integer	Ναι	0-23
minute	integer	Ναι	0-59
dayOfWeek	integer	Για weekly	0=Δευ, 6=Κυρ
dayOfMonth	integer	Για monthly	1-31
timezone	string	Ναι	Ζώνη ώρας IANA (π.χ. UTC, Europe/Berlin)
scanType	string	Ναι	compliance ή exposure
enabled	boolean	Οχι	Προεπιλογή true

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

curl -X POST https://api.aether365.io/tenants/me/scheduled-scans \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Monthly exposure scan",
    "frequency": "monthly",
    "hour": 3,
    "minute": 0,
    "dayOfMonth": 1,
    "timezone": "UTC",
    "scanType": "exposure",
    "enabled": true
  }'

Σφάλματα

Κωδικός	HTTP	Περιγραφή
SCAN_PLAN_LIMIT_REACHED	429	Ξεπεράστηκε το όριο προσαρμοσμένων προγραμμάτων
VALIDATION_ERROR	400	Λείπουν ή μη έγκυρα πεδία

---

Ενημέρωση Προγραμματισμένης Σάρωσης

Ενημερώνει μια υπάρχουσα προγραμματισμένη σάρωση. Ενημερώνονται μόνο τα πεδία που συμπεριλαμβάνετε.

PATCH /tenants/me/scheduled-scans/{scheduledScanId}

Παράδειγμα: Παύση προγράμματος

curl -X PATCH https://api.aether365.io/tenants/me/scheduled-scans/sched_abc123 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"enabled": false}'

Παράδειγμα: Αλλαγή ώρας

curl -X PATCH https://api.aether365.io/tenants/me/scheduled-scans/sched_abc123 \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"hour": 8}'

---

Διαγραφή Προγραμματισμένης Σάρωσης

Διαγράφει μόνιμα μια προγραμματισμένη σάρωση και το υποκείμενο πρόγραμμά της.

DELETE /tenants/me/scheduled-scans/{scheduledScanId}

WARNING

Η αυτόματη σάρωση πλάνου (id: "plan") δεν μπορεί να διαγραφεί μέσω API.

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

curl -X DELETE https://api.aether365.io/tenants/me/scheduled-scans/sched_abc123 \
  -H "Authorization: Bearer <token>"

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

{
  "success": true,
  "data": null
}