API Scanări programate

Scanările programate definesc joburi de scanare recurente. Fiecare scanare programată definește un declanșator recurent care se activează la intervalul configurat.

Listarea scanărilor programate

Returnează toate scanările programate pentru tenant-ul autentificat, inclusiv scanarea automată a planului.

GET /tenants/me/scheduled-scans

Exemplu de cerere

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

Exemplu de răspuns

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

Câmpuri răspuns

Câmp	Tip	Descriere
id	string	Identificator programare ("plan" pentru scanarea automată a planului)
isPlanSchedule	boolean	true dacă aceasta este scanarea automată a planului
name	string	Nume afișat
frequency	string	daily, weekly sau monthly
hour	integer	Ora din zi la care se declanșează (0-23)
minute	integer	Minutul din oră la care se declanșează (0-59)
dayOfWeek	integer	Ziua din săptămână pentru programări săptămânale (0=Luni, 6=Duminică)
dayOfMonth	integer	Ziua din lună pentru programări lunare (1-31)
timezone	string	Fus orar IANA
enabled	boolean	Dacă programarea este activă
scanType	string	compliance sau exposure
lastTriggeredAt	string sau null	Marcaj temporal ISO 8601 al ultimei declanșări

---

Crearea unei scanări programate

Creează o scanare programată nouă.

POST /tenants/me/scheduled-scans

Corp cerere

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

Câmp	Tip	Obligatoriu	Descriere
name	string	Da	Nume afișat
frequency	string	Da	daily, weekly sau monthly
hour	integer	Da	0-23
minute	integer	Da	0-59
dayOfWeek	integer	Pentru weekly	0=Luni, 6=Duminică
dayOfMonth	integer	Pentru monthly	1-31
timezone	string	Da	Fus orar IANA (de exemplu, UTC, Europe/Berlin)
scanType	string	Da	compliance sau exposure
enabled	boolean	Nu	Implicit true

Exemplu de cerere

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
  }'

Erori

Cod	HTTP	Descriere
SCAN_PLAN_LIMIT_REACHED	429	Limita de programări personalizate atinsă pentru planul dvs.
VALIDATION_ERROR	400	Câmpuri lipsă sau invalide

---

Actualizarea unei scanări programate

Actualizează o scanare programată existentă. Doar câmpurile pe care le includeți sunt actualizate.

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

Exemplu: Punerea în pauză a unei programări

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}'

Exemplu: Schimbarea orei

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}'

---

Ștergerea unei scanări programate

Șterge permanent o scanare programată și programarea subiacentă.

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

WARNING

Scanarea automată a planului (id: "plan") nu poate fi ștearsă prin API.

Exemplu de cerere

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

Exemplu de răspuns

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