API web e interfacce tecniche¶

Gli endpoint custom sotto api/ restituiscono JSON e nella modalità operativa usano il MES. I percorsi sono relativi alla root della Platform, non al sito del manuale.

Letture dashboard¶

Metodo e percorso	Parametri	Dati principali
`GET api/dashboard.php`	`_` facoltativo per cache-busting	`server_time`, `kpi`, `machines`
`GET api/engine_activity.php`	`_` facoltativo	`ok`, `timezone`, `server_time`, `engine_activity`
`GET api/machine_detail.php`	`id` obbligatorio; `date=YYYY-MM-DD` facoltativo	`machine`, `events`, `counters`, `day_context`, `scheduled_pauses`, `stop_causes`
`GET api/machine_productions.php`	`id`; `period=30/60/90/120/year/all`	`machine`, `period`, `summary`, `tree`, `rows`

engine_activity descrive l'ultima run conclusa con rows_read>0 e può essere null. L'orario è convertito dal valore UTC nel fuso configurato, con fallback Europe/Rome.

Dashboard e dettaglio espongono last_signal_at nel campo JSON storico updated_at, convertito al fuso applicativo. Questo valore rappresenta l'evento sorgente, non il polling gateway.

I campi opzionali sono accompagnati da flag show_<campo>. Le API verificano schema, regola e sorgente abilitate prima di mostrarli; senza colonne o mapping valido mantengono i flag a false.

Scritture¶

POST api/update_stop_cause.php riceve:

{"event_id":123,"cause_id":1}

Verifica la causale e aggiorna soltanto eventi stop_threshold.

POST api/update_production_note.php riceve:

{"production_id":123,"note_key":"chiave-fallback","note":"Testo nota"}

Aggiorna machine_productions.note, con limite di 255 caratteri. Gli identificativi negli esempi sono illustrativi e devono riferirsi a record validi.

Endpoint Platform Setting¶

setting/ajax-mapping-source-schema.php: restituisce tables, columns_by_table, update_tables, update_columns_by_table e warnings; distingue sorgente di lettura e tabella fisica di update.
GET setting/ajax-mapping-source-config.php: senza parametri elenca file/profili; con file e section prepara i dati non sensibili da importare nella form.

Questi endpoint richiedono login Platform Setting e permessi view sulle tabelle coinvolte. Il secondo non restituisce password inline, soltanto metadati o riferimenti ammessi.

Accessi e perimetro¶

Nelle memorie non è documentato un layer di autenticazione custom degli endpoint dashboard. L'autenticazione Platform Setting del setting non dimostra automaticamente che tutte le API web siano protette. Verificare i controlli effettivi prima di esporre la Platform.

Non risulta una specifica OpenAPI versionata o un contratto completo dei codici di errore. L'engine usa CLI e tabelle MES, senza endpoint HTTP dedicati.