OCPP Logs
Kontext
Die OCPP Logs API bietet Zugriff auf dieselben OCPP-Protokolle (Open Charge Point Protocol), die im ChargePilot Dashboard unter dem Bereich OCPP Logs verfügbar sind. Die Logs erfassen die Kommunikation zwischen Ihren Ladestationen und dem ChargePilot-Controller und sind nützlich für Fehlersuche, Audits und die Überwachung des Ladestationsverhaltens.
Die von dieser API zurückgegebenen Daten entsprechen direkt den Feldern, die beim OCPP Logs Download im ChargePilot Dashboard verfügbar sind. Detaillierte Feldbeschreibungen und Beispiele finden Sie in diesem Artikel.
Einschränkungen
- OCPP Logs sind nur für die letzten 90 Tage verfügbar.
Verfügbare Endpoints
GET /ocpp-logs/site/{id}- OCPP Logs für einen bestimmten Standort abrufen
Gibt eine paginierte Liste von OCPP-Log-Einträgen für den angegebenen Standort zurück, gefiltert nach Zeitraum und optional nach Aktionstyp.
Pfadparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
id | string | Ja | Die ID des Standorts, für den OCPP Logs abgerufen werden sollen |
Abfrageparameter
| Parameter | Typ | Erforderlich | Beschreibung |
|---|---|---|---|
from | string (ISO 8601) | Ja | Beginn des Zeitraums |
to | string (ISO 8601) | Ja | Ende des Zeitraums |
actions | string | Nein | Kommagetrennte Liste von OCPP-Aktionen zum Filtern (siehe Aktionswerte) |
sort_order | asc | desc | Nein | Sortierreihenfolge der Ergebnisse nach occurrence_time |
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
{
"ocpp_logs": [
/* array of OCPPLog objects */
],
"count": 42
}Daten
Jeder Log-Eintrag enthält die folgenden Felder:
Hauptfelder
| Feld | Typ | Beschreibung |
|---|---|---|
occurrence_time | string (ISO 8601) | Zeitstempel des Auftretens der OCPP-Nachricht |
action | string | OCPP-Aktionstyp (siehe Aktionswerte) |
payload | object | Roher Payload der OCPP-Nachricht |
site_id | string | ID des Standorts, zu dem dieser Log gehört |
site_name | string | Anzeigename des Standorts |
charger_id | string | ID der Ladestation, die den Log erzeugt hat |
connector_id | number | Connector-Nummer an der Ladestation |
Anfrage-Felder
Diese Felder werden aus der OCPP-Anfragenachricht extrahiert, sofern zutreffend.
| Feld | Typ | Beschreibung |
|---|---|---|
request_timestamp | string | Zeitstempel der Anfragenachricht |
request_info | string | Zusätzliche Informationen aus der Anfrage |
request_status | string | In der Anfrage gemeldeter Status |
request_reason | string | In der Anfrage angegebener Grund |
request_id_tag | string | RFID-/ID-Tag der Anfrage |
request_transaction_id | number | In der Anfrage referenzierte Transaktions-ID |
request_vendor_id | string | Hersteller-ID aus einer DataTransfer-Anfrage |
request_error_code | string | Fehlercode der Anfrage |
request_vendor_error_code | string | Herstellerspezifischer Fehlercode |
request_meter_stop | string | Zählerwert beim Transaktionsstopp |
Ladeprofil-Felder
Diese Felder werden aus dem Ladeprogramm einer SetChargingProfile-Anfrage extrahiert.
| Feld | Typ | Beschreibung |
|---|---|---|
req_cs_profile_sched_charging_rate_unit | string | Einheit der Laderate (A oder W) |
req_cs_profile_sched_duration | number | Dauer des Ladeprogramms (Sekunden) |
req_cs_profile_sched_start_schedule | string (ISO 8601) | Startzeit des Ladeprogramms |
req_cs_profile_sched_min_charging_rate | number | Minimale Laderate im Programm |
req_cs_profile_sched_schedule_period | array | Programmperioden (siehe unten) |
Programmperiode
| Feld | Typ | Beschreibung |
|---|---|---|
start_period | number | Versatz in Sekunden ab Programmstart |
limit | number | Laderaten-Limit für diese Periode |
number_phases | number | Anzahl der zu verwendenden Phasen |
Antwort-Felder
| Feld | Typ | Beschreibung |
|---|---|---|
response_id_tag_info_status | string | Autorisierungsstatus, der für ein ID-Tag zurückgegeben wird |
Extrahierte Zählerwerte
Diese Felder werden aus MeterValues-Nachrichten geparst und ermöglichen einfachen Zugriff ohne Verarbeitung des rohen Payloads.
| Feld | Typ | Beschreibung |
|---|---|---|
extracted_voltage | number | Gesamtspannung (V) |
extracted_voltage_phase1 | number | Spannung auf Phase 1 (V) |
extracted_voltage_phase2 | number | Spannung auf Phase 2 (V) |
extracted_voltage_phase3 | number | Spannung auf Phase 3 (V) |
extracted_current | number | Gesamtstrom (A) |
extracted_current_phase1 | number | Strom auf Phase 1 (A) |
extracted_current_phase2 | number | Strom auf Phase 2 (A) |
extracted_current_phase3 | number | Strom auf Phase 3 (A) |
extracted_power | number | Gesamtwirkleistung (W) |
extracted_power_phase1 | number | Wirkleistung auf Phase 1 (W) |
extracted_power_phase2 | number | Wirkleistung auf Phase 2 (W) |
extracted_power_phase3 | number | Wirkleistung auf Phase 3 (W) |
extracted_state_of_charge | number | Ladezustand der Batterie (%) |
Aktionswerte
Das Feld action (sowie der Filterparameter actions) akzeptiert einen der folgenden OCPP 1.6 / OCPP 2.0 Aktionsnamen:
Authorize, BootNotification, CancelReservation, CertificateSigned, ChangeAvailability, ChangeConfiguration, ClearCache, ClearChargingProfile, DataTransfer, DeleteCertificate, DiagnosticsStatusNotification, ExtendedTriggerMessage, FirmwareStatusNotification, GetCompositeSchedule, GetConfiguration, GetDiagnostics, GetInstalledCertificateIds, GetLocalListVersion, GetLog, Heartbeat, InstallCertificate, LogStatusNotification, MeterValues, RemoteStartTransaction, RemoteStopTransaction, ReserveNow, Reset, SecurityEventNotification, SendLocalList, SetChargingProfile, SignCertificate, SignedFirmwareStatusNotification, SignedUpdateFirmware, StartTransaction, StatusNotification, StopTransaction, TriggerMessage, UnlockConnector, UpdateFirmware