Fehlerereignisse

Kontext

Die Fehlerereignis-API bietet Zugriff auf dieselben Fehlerereignisse, die im ChargePilot Dashboard im Bereich Fehlerereignisse verfügbar sind. Ein Fehlerereignis wird ausgelöst, wenn ein Local Controller offline geht oder wenn eine Ladestation bzw. einer ihrer Anschlüsse einen Fehler meldet. Es wird wieder geschlossen, sobald sich das Gerät erholt hat.

Jedes Ereignis wird durch eine event_id identifiziert. Verwenden Sie den Listen-Endpoint, um Ereignisse für einen Standort zu finden, und anschließend den Detail-Endpoint, um den vollständigen Datensatz für ein einzelnes Ereignis abzurufen.

Verfügbare Endpoints

• GET /error-events/site/{id} - Fehlerereignisse für einen bestimmten Standort abrufen
• GET /error-events/site/{id}/{event_id} - Ein einzelnes Fehlerereignis abrufen

GET /error-events/site/{id}

Gibt eine paginierte Liste von Fehlerereignissen 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 Fehlerereignisse abgerufen werden sollen

Abfrageparameter

Parameter	Typ	Erforderlich	Beschreibung
start_date	string (ISO 8601)	Ja	Beginn des Zeitraums
end_date	string (ISO 8601)	Ja	Ende des Zeitraums
search_text	string	Nein	Freitextsuche in Geräte-ID, Fehlermeldung und Ladepunktname (max. 100 Zeichen)
sort_field	string	Nein	Feld, nach dem die Ergebnisse sortiert werden — siehe Sortierfelder
sort_order	asc | desc	Nein	Sortierreihenfolge der Ergebnisse (Standard: desc)
take	number	Nein	Anzahl der zurückzugebenden Datensätze (max. 200)
skip	number	Nein	Anzahl der zu überspringenden Datensätze für die Paginierung

Antwort

{
  "events": [
    {
      "event_id": "0f1c1f2e-9c4a-4a1f-8a1e-2f0f9b0f3c11",
      "error_status": "active",
      "device_id": "a1b2c3d4",
      "charging_point_name": "Charging Point 1",
      "error_message": "GroundFailure",
      "error_date": "2026-05-15T10:00:00.000Z",
      "automatic_recovery_status": "initiated",
      "site_name": "Depot North",
      "case_type": "connector_error"
    }
  ],
  "records_count": 42
}

Feld	Typ	Beschreibung
events	array	Liste der Fehlerereignis-Objekte
records_count	number	Gesamtzahl der übereinstimmenden Datensätze

GET /error-events/site/{id}/{event_id}

Gibt den vollständigen Datensatz für ein einzelnes Fehlerereignis zurück, einschließlich des Behebungszeitpunkts und etwaiger herstellerspezifischer Fehlerinformationen der Ladestation.

Antwortet mit 404, wenn zur angegebenen event_id kein Fehlerereignis existiert.

Pfadparameter

Parameter	Typ	Erforderlich	Beschreibung
id	string	Ja	Die ID des Standorts, zu dem das Fehlerereignis gehört
event_id	string	Ja	Die ID des Fehlerereignisses, wie vom Listen-Endpoint in event_id zurückgegeben

Antwort

{
  "site_name": "Depot North",
  "controller_id": "a1b2c3d4",
  "charger_id": "charger-1",
  "charging_point_name": "Charging Point 1",
  "error_status": "recovered",
  "error_message": "GroundFailure",
  "error_occurred": "2026-05-15T10:00:00.000Z",
  "error_resolved": "2026-05-15T11:00:00.000Z",
  "automatic_recovery_status": "initiated",
  "automatic_recovery_time": "2026-05-15T10:30:00.000Z",
  "case_type": "connector_error",
  "vendor_error_code": null,
  "vendor_info": null
}

Daten

Fehlerereignis

Jeder Eintrag im events-Array enthält die folgenden Felder:

Feld	Typ	Beschreibung
event_id	string	Eindeutige Kennung des Fehlerereignisses
error_status	string	Ob der Fehler noch besteht — siehe Fehlerstatus
device_id	string	ID des Local Controllers oder der Ladestation, die den Fehler gemeldet hat
charging_point_name	string	Anzeigename des betroffenen Ladepunkts
error_message	string	Der gemeldete Fehler, typischerweise ein OCPP-Fehlercode (z. B. GroundFailure, Offline)
error_date	string (ISO 8601)	Zeitpunkt, zu dem der Fehler aufgetreten ist
automatic_recovery_status	string	Siehe Status der automatischen Wiederherstellung
site_name	string	Anzeigename des Standorts
case_type	string	Welche Art von Gerät ausgefallen ist — siehe Fehlerarten

Fehlerereignis-Details

Der Endpoint für ein einzelnes Ereignis gibt die folgenden Felder zurück:

Feld	Typ	Beschreibung
site_name	string	Anzeigename des Standorts
controller_id	string	ID des Local Controllers, der das betroffene Gerät verwaltet
charger_id	string	ID der betroffenen Ladestation
charging_point_name	string	Anzeigename des betroffenen Ladepunkts
error_status	string	Ob der Fehler noch besteht — siehe Fehlerstatus
error_message	string	Der gemeldete Fehler, typischerweise ein OCPP-Fehlercode
error_occurred	string (ISO 8601)	Zeitpunkt, zu dem der Fehler aufgetreten ist
error_resolved	string (ISO 8601)	Zeitpunkt der Behebung, oder null, solange der Fehler noch aktiv ist
automatic_recovery_status	string	Siehe Status der automatischen Wiederherstellung
automatic_recovery_time	string (ISO 8601)	Zeitpunkt des letzten Wiederherstellungsversuchs. Sagt nichts darüber aus, ob dieser erfolgreich war
case_type	string	Welche Art von Gerät ausgefallen ist — siehe Fehlerarten
vendor_error_code	string	Herstellerspezifischer Fehlercode der Ladestation, sofern verfügbar
vendor_info	string	Zusätzliche herstellerspezifische Fehlerinformationen, sofern verfügbar

Jedes Feld kann null sein, wenn die zugrunde liegenden Daten nicht verfügbar sind.

Fehlerstatus

Wert	Beschreibung
active	Der Fehler besteht weiterhin und das Gerät hat sich nicht erholt
recovered	Das Gerät hat sich erholt und der Fehler ist geschlossen

Fehlerarten

Wert	Beschreibung
controller_error	Der Local Controller ist offline gegangen
charger_error	Die Ladestation hat einen Fehler oder eine Störung gemeldet
connector_error	Ein Anschluss der Ladestation hat einen Fehler oder eine Störung gemeldet

Status der automatischen Wiederherstellung

ChargePilot versucht, einige Fehler automatisch zu beheben, beispielsweise durch einen Neustart der betroffenen Ladestation.

Wert	Beschreibung
initiated	Für diesen Fehler wurde eine automatische Wiederherstellung ausgelöst
not_initiated	Es wurde keine automatische Wiederherstellung ausgelöst — entweder ist sie für diesen Fehler nicht vorgesehen, sie steht noch aus, oder ein vorheriger Versuch wurde nicht abgeschlossen

Sortierfelder

Der Abfrageparameter sort_field akzeptiert die folgenden Werte:

Wert	Beschreibung
error_date	Nach Zeitpunkt des Fehlers sortieren
error_status	Nach Fehlerstatus sortieren
device_id	Nach Geräte-ID sortieren
charging_point_name	Nach Ladepunktname sortieren
error_message	Nach Fehlermeldung sortieren
case_type	Nach Fehlerart sortieren
site_name	Nach Standortname sortieren
automatic_recovery_status	Nach Status der automatischen Wiederherstellung sortieren