Que pouvez-vous faire avec l’API REST ?
- Lecture : bornes et état des connecteurs, sessions de recharge en cours et passées, conducteurs, badges RFID, véhicules, alertes et présentations de badge refusées.
- Écriture : créez, modifiez et supprimez conducteurs, badges RFID et véhicules — par exemple pour provisionner automatiquement les salariés depuis votre SIRH.
- Commandes : arrêtez une session à distance, redémarrez une borne, déverrouillez un connecteur et suivez le résultat de la commande.
- Rapports : rapports énergétiques groupés par jour, mois, borne, conducteur ou véhicule.
Événements en temps réel avec les webhooks
Au lieu d’interroger l’API en boucle, les événements arrivent sur votre serveur dès qu’ils se produisent : session.started, session.stopped, connector.status_changed, station.connected, station.disconnected, auth.rejected, alert.created et command.completed. Chaque requête est signée en HMAC-SHA256 et les envois échoués sont relancés automatiquement.
Une sécurité de niveau entreprise
- Portées (lecture, écriture, commandes) pour un accès au moindre privilège
- Listes d’IP autorisées et clés avec date d’expiration
- Limites de débit par clé et journalisation complète des requêtes
- Clés stockées sous forme hachée sur le serveur
Documentation développeur
Chaque point de terminaison est documenté avec des exemples cURL, PHP, Node.js et Python. Créez votre clé API en quelques minutes depuis la page Paramètres API du tableau de bord.
Questions fréquentes
L’API est-elle payante ?
Non. L’API et les webhooks sont inclus dans tous les comptes.
Dans quel format sont les données ?
Toutes les réponses sont en JSON, avec des horodatages ISO-8601 incluant le décalage horaire.
Et si je ne peux pas recevoir de webhooks ?
Vous pouvez interroger les mêmes événements via le point de terminaison du flux d’événements.