Ladevorgänge
Kontext
Die Ladevorgänge-API bietet Zugriff auf abgeschlossene Ladevorgänge für Ihre Standorte. Jeder Ladevorgang repräsentiert eine einzelne Transaktion – vom Beginn bis zum Ende eines Ladevorgangs – und enthält Energie-, Zeit- und Ladezustandsdaten, sofern verfügbar.
Verfügbare Endpoints
GET /charging-events/site/{id}- Ladevorgänge für einen bestimmten Standort abrufen
Gibt eine paginierte Liste von Ladevorgängen für den angegebenen Standort zurück, gefiltert nach Zeitraum und optional durchsuch- sowie sortierbar.
Pfadparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
id | string | Ja | Die ID des Standorts, für den Ladevorgänge abgerufen werden sollen |
Abfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
from | string (ISO 8601) | Ja | Beginn des Zeitraums |
to | string (ISO 8601) | Ja | Ende des Zeitraums |
search_text | string | Nein | Freitextsuche in den Ladevorgangsdaten (max. 100 Zeichen) |
sort_field | string | Nein | Feld, nach dem die Ergebnisse sortiert werden — siehe Sortierfelder |
sort_order | asc | desc | Nein | Sortierreihenfolge der Ergebnisse |
take | number | Nein | Anzahl der zurückzugebenden Datensätze (max. 1000) |
skip | number | Nein | Anzahl der zu überspringenden Datensätze für die Paginierung |
Antwort
Der Endpoint gibt ein JSON-Array von Ladevorgangsobjekten zurück, sortiert gemäß den Parametern sort_field und sort_order. Verwenden Sie take und skip, um durch die Ergebnisse zu blättern.
[
{
"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
}
]Daten
Jeder Ladevorgang enthält die folgenden Felder:
| Feld | Typ | Beschreibung |
|---|---|---|
TransactionID | number | Eindeutiger Bezeichner des Ladevorgangs |
SiteName | string | null | Anzeigename des Standorts, an dem der Ladevorgang stattfand |
ChargerType | AC | DC | null | Gibt an, ob die Ladestation AC oder DC ist |
ChargerID | string | ID der Ladestation |
ConnectorID | number | Connector-Nummer an der Ladestation |
StartAt | string (ISO 8601) | Startzeit des Ladevorgangs |
EndAt | string (ISO 8601) | Endzeit des Ladevorgangs |
InitialSoC | number | null | Ladezustand zu Beginn des Ladevorgangs (%) |
BusID | string | null | Kennung des Ladevorgangs, abgeleitet vom Namen des RFID-Tags |
EndSoC | number | null | Ladezustand am Ende des Ladevorgangs (%) |
EnergyDelivered | number | null | Gesamte während des Ladevorgangs gelieferte Energie (kWh) |
Sortierfelder
Der Abfrageparameter sort_field akzeptiert die folgenden Werte. Die Sortierung erfolgt auf dem zugrunde liegenden Ladevorgangsdatensatz, sodass einige Sortierschlüssel (z. B. cost, duration) gültig sind, auch wenn sie nicht im Antwortkörper zurückgegeben werden:
| Wert | Beschreibung |
|---|---|
occurrence_time | Nach Aufzeichnungszeitpunkt des Ereignisses sortieren |
rfid | Nach RFID-Tag sortieren |
rfid_name | Nach Anzeigename des RFID-Tags sortieren |
energy_consumed | Nach gelieferter Energie sortieren |
duration | Nach Ladevorgangsdauer sortieren |
cost | Nach tatsächlichen Kosten sortieren |
optimized_cost | Nach DTO-optimierten Kosten sortieren |
cost_savings | Nach Kostenersparnis sortieren |