API Analyses programmées

Maintenu par : Aether365 Team Public : Développeurs Périmètre : Endpoints de l'API Scheduled Scans - création et gestion des calendriers d'analyse

Les analyses programmées définissent des tâches d'analyse récurrentes. Chaque analyse programmée définit un déclencheur récurrent qui s'exécute à l'intervalle configuré.

Lister les analyses programmées

Renvoie toutes les analyses programmées pour le tenant authentifié, y compris l'analyse automatique du plan.

GET /tenants/me/scheduled-scans

Exemple de requête

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

Exemple de réponse

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

Champs de la réponse

Champ	Type	Description
id	string	Identifiant du calendrier ("plan" pour l'analyse automatique du plan)
isPlanSchedule	boolean	true s'il s'agit de l'analyse automatique du plan
name	string	Nom d'affichage
frequency	string	daily, weekly ou monthly
hour	integer	Heure de déclenchement (0-23)
minute	integer	Minute de déclenchement (0-59)
dayOfWeek	integer	Jour de la semaine pour les calendriers hebdomadaires (0=Lun, 6=Dim)
dayOfMonth	integer	Jour du mois pour les calendriers mensuels (1-31)
timezone	string	Chaîne de fuseau horaire IANA
enabled	boolean	Indique si le calendrier est actif
scanType	string	compliance ou exposure
lastTriggeredAt	string ou null	Horodatage ISO 8601 du dernier déclenchement

---

Créer une analyse programmée

Crée une nouvelle analyse programmée.

POST /tenants/me/scheduled-scans

Corps de la requête

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

Champ	Type	Requis	Description
name	string	Oui	Nom d'affichage
frequency	string	Oui	daily, weekly ou monthly
hour	integer	Oui	0-23
minute	integer	Oui	0-59
dayOfWeek	integer	Pour weekly	0=Lun, 6=Dim
dayOfMonth	integer	Pour monthly	1-31
timezone	string	Oui	Fuseau horaire IANA (ex. UTC, Europe/Berlin)
scanType	string	Oui	compliance ou exposure
enabled	boolean	Non	Par défaut true

Exemple de requête

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

Erreurs

Code	HTTP	Description
SCAN_PLAN_LIMIT_REACHED	429	Limite de calendriers personnalisés atteinte pour votre plan
VALIDATION_ERROR	400	Champs manquants ou invalides

---

Mettre à jour une analyse programmée

Met à jour une analyse programmée existante. Seuls les champs inclus sont mis à jour.

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

Exemple : Suspendre un calendrier

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

Exemple : Modifier l'heure

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

---

Supprimer une analyse programmée

Supprime définitivement une analyse programmée et son calendrier sous-jacent.

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

WARNING

L'analyse automatique du plan (id: "plan") ne peut pas être supprimée via l'API.

Exemple de requête

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

Exemple de réponse

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