Live-Daten

Kontext

Die Live-Daten-API liefert Echtzeitinformationen zu Ihren Standorten — einschließlich des aktuellen Status jedes Ladepunkts sowie einer Zeitreihenansicht des Stromverbrauchs und der Limits auf Standortebene. Diese Daten entsprechen der Live-Ansicht im ChargePilot Dashboard.

Verfügbare Endpoints

• GET /live/site/{id}/charging-points - Aktuellen Status aller Ladepunkte eines Standorts abrufen
• GET /live/site/{id}/power-and-limits - Zeitreihendaten zu Leistung und Limits eines Standorts abrufen

---

GET /live/site/{id}/charging-points

Gibt den aktuellen Live-Status jedes Ladepunkts am angegebenen Standort zurück, einschließlich Steckerstatus, Energie der aktiven Sitzung, Ladezustand und etwaiger OCPP-Fehler.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
id	string	Ja	Die ID des abzufragenden Standorts

Abfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
sortField	string	Nein	Feld zum Sortieren der Ergebnisse — siehe Sortierfelder
sortOrder	asc | desc	Nein	Sortierrichtung
take	number	Nein	Anzahl der zurückzugebenden Datensätze (max. 100)
skip	number	Nein	Anzahl der zu überspringenden Datensätze für die Paginierung
onlyCurrentlyPluggedIn	boolean	Nein	Wenn true, werden nur aktuell eingesteckte Ladepunkte zurückgegeben. Akzeptiert true oder false.
searchText	string	Nein	Volltextfilter für Ladepunkt-Namen und RFID-Namen

Antwort

{
  "charging_points": [
    /* Array von ChargingPoint-Objekten */
  ],
  "count": 12
}

Feld	Typ	Beschreibung
charging_points	array	Liste der Ladepunkt-Objekte (siehe Daten)
count	number	Gesamtzahl der passenden Ladepunkte

---

GET /live/site/{id}/power-and-limits

Gibt Zeitreihendaten zum Stromverbrauch und zu aktiven Limits auf Standortebene über den angegebenen Zeitraum zurück. Jeder Eintrag stellt ein Messintervall dar, mit Aufschlüsselung pro Phase und dem zu diesem Zeitpunkt aktiven Limit.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
id	string	Ja	Die ID des abzufragenden Standorts

Abfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
from	string (ISO 8601)	Ja	Beginn des Zeitraums
to	string (ISO 8601)	Ja	Ende des Zeitraums
fuse	number	Nein	Ergebnisse auf einen bestimmten Sicherungswert filtern

Antwort

[
  /* Array von SitePowerAndLimits-Objekten */
]

Ein Array von SitePowerAndLimits-Objekten, aufsteigend sortiert nach chunk_start.

---

Daten

Ladepunkt-Felder

Feld	Typ	Erforderlich	Beschreibung
id	number	Ja	Interne numerische Kennung des Ladepunkts
uuid	string	Ja	UUID des Ladepunkts
status	string	Ja	Aktueller Status — siehe Statuswerte
name	string	Ja	Anzeigename des Ladepunkts
prioritized	boolean	Ja	Gibt an, ob dieser Ladepunkt eine Ladepriorität erhalten hat
charger_id	string	Ja	ID der übergeordneten Ladestation
device_id	string	Ja	Gerätekennung, die für die Kommunikation verwendet wird
ocpp_error	object	Nein	Aktiver OCPP-Fehler, falls vorhanden — enthält code (string) und vendor_code (string | null)
rfid	string	Nein	RFID-Tag-ID der aktuellen oder letzten Sitzung
rfid_name	string	Nein	Anzeigename, der dem RFID-Tag zugeordnet ist
rfid_time	string (ISO 8601)	Nein	Zeitstempel, wann der RFID-Tag vorgehalten wurde
charging_power	number	Nein	Aktuelle Ladeleistung (W)
current_type	string	Nein	AC oder DC
inbound_power_limit	number	Nein	Aktives eingangsseitiges Leistungslimit für diesen Ladepunkt (W)
session_energy_consumed	number	Nein	In der aktuellen oder letzten Sitzung verbrauchte Energie (Wh)
state_of_charge	number	Nein	Ladezustand der Batterie des angeschlossenen Fahrzeugs (%)
state_of_charge_time	string (ISO 8601)	Nein	Zeitstempel der letzten Ladezustandsmessung
plug_in_time	string (ISO 8601)	Nein	Zeitstempel, wann das Fahrzeug eingesteckt wurde
target_soc	number	Nein	Für die Sitzung festgelegter Ziel-Ladezustand (%)

Statuswerte

Wert	Beschreibung
available	Ladepunkt ist bereit und verfügbar
charging	Ein Fahrzeug lädt aktiv
error	An diesem Ladepunkt liegt ein OCPP-Fehler an
finishing	Die Sitzung wird beendet (z. B. Transaktion wird gestoppt)
offline	Die Ladestation ist nicht erreichbar
paused_ev	Laden wurde durch das Fahrzeug pausiert (z. B. Batterie voll, fahrzeugseitiges Limit)
paused_lm	Laden wurde durch das Lastmanagement pausiert
preparing	Ein Fahrzeug ist verbunden, das Laden hat aber noch nicht begonnen
unavailable	Der Ladepunkt wurde als nicht verfügbar gekennzeichnet
unknown	Der Status kann nicht ermittelt werden

Sortierfelder

Der Abfrageparameter sortField akzeptiert einen der folgenden Werte:

Wert	Beschreibung
name	Nach Ladepunkt-Namen sortieren
status	Nach aktuellem Status sortieren
rfid_name	Nach RFID-Tag-Anzeigename sortieren
charging_power	Nach aktueller Ladeleistung sortieren
session_energy_consumed	Nach in der Sitzung verbrauchter Energie sortieren
state_of_charge	Nach Fahrzeug-Ladezustand sortieren
plug_in_time	Nach Einsteckzeitpunkt sortieren

---

Standortleistungs- und Limit-Felder

Jedes Objekt im Antwort-Array stellt ein Messintervall dar.

Feld	Typ	Erforderlich	Beschreibung
chunk_start	string (ISO 8601)	Ja	Zeitstempel, der den Beginn dieses Messintervalls markiert
total_current_phase1	number	Ja	Gesamtstrom des Standorts auf Phase 1 (A)
total_current_phase2	number	Ja	Gesamtstrom des Standorts auf Phase 2 (A)
total_current_phase3	number	Ja	Gesamtstrom des Standorts auf Phase 3 (A)
total_power	number	Ja	Gesamter Stromverbrauch des Standorts (W)
fleet_current_phase1	number	Ja	Flotten-Strom (EV-Laden) auf Phase 1 (A)
fleet_current_phase2	number	Ja	Flotten-Strom (EV-Laden) auf Phase 2 (A)
fleet_current_phase3	number	Ja	Flotten-Strom (EV-Laden) auf Phase 3 (A)
fleet_power	number	Ja	Gesamte Flottenleistung (EV-Laden) (W)
inbound_opt_current_limit_phase1	number	Ja	Optimiertes eingangsseitiges Stromlimit auf Phase 1 (A)
inbound_opt_current_limit_phase2	number	Ja	Optimiertes eingangsseitiges Stromlimit auf Phase 2 (A)
inbound_opt_current_limit_phase3	number	Ja	Optimiertes eingangsseitiges Stromlimit auf Phase 3 (A)
inbound_current_limit	number	Ja	Aktives eingangsseitiges Stromlimit für den Standort (A)
power_factor_phase1	number	Nein	Leistungsfaktor auf Phase 1
power_factor_phase2	number	Nein	Leistungsfaktor auf Phase 2
power_factor_phase3	number	Nein	Leistungsfaktor auf Phase 3
inbound_power_limit	number	Nein	Aktives eingangsseitiges Leistungslimit für den Standort (W)
overridden_inbound_current_limit	number	Nein	Manuell überschriebener Wert für das eingangsseitige Stromlimit (A), falls aktiv
overridden_inbound_power_limit	number	Nein	Manuell überschriebener Wert für das eingangsseitige Leistungslimit (W), falls aktiv