Cosa puoi fare con l’API REST?
- Lettura: colonnine e stato dei connettori, sessioni di ricarica attive e passate, conducenti, tessere RFID, veicoli, avvisi e tentativi con tessera rifiutati.
- Scrittura: crea, modifica ed elimina conducenti, tessere RFID e veicoli — ad esempio per attivare automaticamente il personale dal tuo sistema HR.
- Comandi: interrompi una sessione da remoto, riavvia una colonnina, sblocca un connettore e segui l’esito del comando.
- Report: report energetici raggruppati per giorno, mese, colonnina, conducente o veicolo.
Eventi in tempo reale con i webhook
Invece di interrogare l’API di continuo, gli eventi raggiungono il tuo server nel momento in cui accadono: session.started, session.stopped, connector.status_changed, station.connected, station.disconnected, auth.rejected, alert.created e command.completed. Ogni richiesta è firmata con HMAC-SHA256 e gli invii non riusciti vengono ritentati automaticamente.
Sicurezza di livello enterprise
- Scope (lettura, scrittura, comandi) per un accesso con privilegi minimi
- Liste di IP consentiti e chiavi con data di scadenza
- Limiti di frequenza per chiave e registrazione completa delle richieste
- Chiavi salvate sul server in forma hash
Documentazione per sviluppatori
Ogni endpoint è documentato con esempi in cURL, PHP, Node.js e Python. Crea la tua chiave API in pochi minuti dalla pagina Impostazioni API della dashboard.
Domande frequenti
L’API ha un costo aggiuntivo?
No. API e webhook sono inclusi in ogni account.
In che formato sono i dati?
Tutte le risposte sono in JSON, con timestamp ISO-8601 comprensivi del fuso orario.
E se non posso ricevere webhook?
Puoi interrogare gli stessi eventi tramite l’endpoint del flusso eventi.