Riferimento API
API di Manutenzione
Endpoint CRUD dei piani, esecuzione, anteprima, notifica di test, pausa/ripresa, contatori, cronologia, conformita e ottimizzazione.
Endpoint dei Piani
| Metodo | Endpoint | Descrizione |
|---|---|---|
GET | /api/v1/maintenance/plans | Elenco piani |
POST | /api/v1/maintenance/plans | Crea piano |
GET | /api/v1/maintenance/plans/{plan_id} | Ottieni piano |
PUT | /api/v1/maintenance/plans/{plan_id} | Aggiorna piano |
DELETE | /api/v1/maintenance/plans/{plan_id} | Elimina piano |
Esecuzione e Anteprima
| Metodo | Endpoint | Descrizione |
|---|---|---|
POST | /api/v1/maintenance/plans/{plan_id}/execute | Esegui piano manualmente |
GET | /api/v1/maintenance/plans/{plan_id}/preview | Anteprima dell'attivita |
POST | /api/v1/maintenance/plans/{plan_id}/test-notification | Invia notifica di test |
Eseguire un Piano
Forza l'esecuzione immediata del piano, generando l'attivita senza attendere lo scheduler:
POST /api/v1/maintenance/plans/{plan_id}/executeRisposta 200:
{
"task_id": "task_abc123",
"task_code": "MAN-042",
"next_due_at": "2026-04-24T10:00:00Z"
}Anteprima dell'Attivita
Mostra come sarebbe l'attivita generata senza eseguire il piano:
GET /api/v1/maintenance/plans/{plan_id}/previewPausa e Ripresa
| Metodo | Endpoint | Descrizione |
|---|---|---|
POST | /api/v1/maintenance/plans/{plan_id}/pause | Pausa piano |
POST | /api/v1/maintenance/plans/{plan_id}/resume | Riprendi piano |
Mettere in pausa un piano preserva la data
next_due_at. Alla ripresa, viene ricalcolata se la data e passata.Contatori
Per piani con trigger basato su contatore:
| Metodo | Endpoint | Descrizione |
|---|---|---|
POST | /api/v1/maintenance/plans/{plan_id}/counter | Aggiorna contatore |
GET | /api/v1/maintenance/plans/{plan_id}/counter/history | Cronologia contatore |
POST /api/v1/maintenance/plans/{plan_id}/counter
{
"value": 523,
"source": "gateway_001"
}Se il valore raggiunge la soglia, il piano viene eseguito automaticamente.
Cronologia delle Esecuzioni
GET /api/v1/maintenance/plans/{plan_id}/history?skip=0&limit=20Ogni voce include:
| Campo | Descrizione |
|---|---|
execution_id | ID univoco dell'esecuzione |
task_id | Attivita generata |
trigger | calendar o counter |
executed_at | Timestamp dell'esecuzione |
executed_by | system o user_id |
Conformita
GET /api/v1/maintenance/compliance?start_date=2026-01-01&end_date=2026-03-31Restituisce metriche di conformita della manutenzione preventiva:
| Metrica | Descrizione |
|---|---|
compliance_rate | % dei piani eseguiti in tempo |
overdue_count | Piani scaduti nel periodo |
on_time_count | Piani eseguiti entro la scadenza |
average_delay_hours | Ritardo medio nelle esecuzioni tardive |
Ottimizzazione
POST /api/v1/maintenance/plans/{plan_id}/optimizeIl motore IA analizza la cronologia del piano e suggerisce modifiche:
- Frequenza ottimale basata sui pattern di guasto
- Redistribuzione del carico di lavoro tra i tecnici
- Consolidamento dei percorsi multi-asset
- Adeguamento delle soglie dei contatori
I suggerimenti vengono presentati come bozza che l'utente approva prima dell'applicazione.