Événements de recharge
Contexte
L'API Événements de recharge donne accès aux enregistrements des sessions de recharge terminées pour vos sites. Chaque événement représente une transaction unique — du début à la fin d'une session de recharge — et inclut des données sur l'énergie, les horaires et l'état de charge, lorsqu'elles sont disponibles.
Endpoints disponibles
GET /charging-events/site/{id}- Récupérer les événements de recharge pour un site spécifique
Retourne une liste paginée d'événements de recharge pour le site donné, filtrée par plage horaire, avec des options de recherche et de tri.
Paramètres de chemin
| Paramètre | Type | Requis | Description |
|---|---|---|---|
id | string | Oui | L'identifiant du site pour lequel récupérer les événements de recharge |
Paramètres de requête
| Paramètre | Type | Requis | Description |
|---|---|---|---|
from | string (ISO 8601) | Oui | Début de la plage horaire |
to | string (ISO 8601) | Oui | Fin de la plage horaire |
search_text | string | Non | Recherche en texte libre dans les données d'événements de recharge (max 100 caractères) |
sort_field | string | Non | Champ sur lequel trier les résultats — voir Champs de tri |
sort_order | asc | desc | Non | Ordre de tri des résultats |
take | number | Non | Nombre d'enregistrements à retourner (max 1000) |
skip | number | Non | Nombre d'enregistrements à ignorer, pour la pagination |
Réponse
L'endpoint retourne un tableau JSON d'objets d'événements de recharge, triés selon les paramètres sort_field et sort_order. Utilisez take et skip pour parcourir les résultats.
[
{
"TransactionID": 123456,
"SiteName": "Berlin Depot",
"ChargerType": "AC",
"ChargerID": "charger-01",
"ConnectorID": 1,
"StartAt": "2026-01-01T08:00:00.000Z",
"EndAt": "2026-01-01T11:30:00.000Z",
"InitialSoC": 20,
"BusID": "Fleet Vehicle 7",
"EndSoC": 85,
"EnergyDelivered": 42.5
}
]Données
Chaque événement de recharge contient les champs suivants :
| Champ | Type | Description |
|---|---|---|
TransactionID | number | Identifiant unique de la transaction de recharge |
SiteName | string | null | Nom d'affichage du site où la session a eu lieu |
ChargerType | AC | DC | null | Indique si la borne de recharge est AC ou DC |
ChargerID | string | Identifiant de la borne de recharge |
ConnectorID | number | Numéro du point de recharge sur la borne de recharge |
StartAt | string (ISO 8601) | Heure de début de la session de recharge |
EndAt | string (ISO 8601) | Heure de fin de la session de recharge |
InitialSoC | number | null | État de charge au début de la session de recharge (%) |
BusID | string | null | Identifiant de la session, dérivé du nom du tag RFID |
EndSoC | number | null | État de charge à la fin de la session de recharge (%) |
EnergyDelivered | number | null | Énergie totale délivrée pendant la session de recharge (kWh) |
Champs de tri
Le paramètre de requête sort_field accepte les valeurs suivantes. Le tri s'applique à l'enregistrement de session sous-jacent ; certains champs de tri (par ex. cost, duration) sont donc valides même s'ils ne figurent pas dans le corps de la réponse :
| Valeur | Description |
|---|---|
occurrence_time | Trier par date d'enregistrement de l'événement |
rfid | Trier par tag RFID |
rfid_name | Trier par nom d'affichage du tag RFID |
energy_consumed | Trier par énergie délivrée |
duration | Trier par durée de session de recharge |
cost | Trier par coût réel |
optimized_cost | Trier par coût optimisé DTO |
cost_savings | Trier par économies réalisées |