# Logs

Im Bereich Logs werden alle API-Aufrufe protokolliert, die über die REST-Schnittstelle von nexcore erfolgen.

Damit kannst Du nachvollziehen, welche Systeme wann welche Daten mit nexcore ausgetauscht haben – eine wichtige Grundlage für die Fehlersuche, Analyse und technische Nachvollziehbarkeit.

***

## Aufbau

Die Ansicht besteht aus zwei Hauptbereichen:

<table><thead><tr><th width="219.953125">Bereich</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>API-Logs (linke Seite)</strong></td><td>Zeigt alle protokollierten Requests in tabellarischer Form. Du siehst hier den <em>Statuscode</em>, die <em>HTTP-Methode</em> (z. B. POST, GET, PUT, DELETE), den <em>Pfad</em> des API-Endpunkts sowie Datum und Uhrzeit des Aufrufs. <br><br>Über die Suchfelder kannst Du gezielt nach Status oder Text suchen. Außerdem kannst Du die Liste manuell "Aktualisieren" und die Einträge wahlweise nach Start auf- oder absteigend sortieren.</td></tr><tr><td><strong>Details (rechte Seite)</strong></td><td>Sobald Du einen Eintrag auswählst, werden die Details zum Request angezeigt – inklusive ID, Status, API-Key, Trace-ID und Request/Response-Body.</td></tr></tbody></table>

***

## Detailansicht eines API-Logs

Für jeden einzelnen Request werden folgende Informationen angezeigt:

<table><thead><tr><th width="220.1875">Feld</th><th>Beschreibung</th></tr></thead><tbody><tr><td><strong>ID</strong></td><td>Eindeutige Kennung des API-Requests.</td></tr><tr><td><strong>Status</strong></td><td>Antwortstatus des Servers (z. B. 200 OK für erfolgreiche Requests oder 400 Bad Request bei fehlerhaften Anfragen).</td></tr><tr><td><strong>Start</strong></td><td>Zeitstempel der API-Anfrage.</td></tr><tr><td><strong>API-Key ID</strong></td><td>Gibt an, mit welchem API-Key der Aufruf erfolgt ist.</td></tr><tr><td><strong>Trace ID</strong></td><td>Interne ID zur Nachverfolgung von Aufrufen über verschiedene Systeme hinweg.</td></tr><tr><td><strong>Transaction ID</strong></td><td>Interne ID zur Nachverfolgung von Aufrufen über verschiedene Systeme hinweg.</td></tr><tr><td><strong>Request ID</strong></td><td>Interne ID zur Nachverfolgung von Aufrufen über verschiedene Systeme hinweg.</td></tr><tr><td><strong>Request Body</strong></td><td>Der vollständige Inhalt der übermittelten Anfrage (JSON).</td></tr><tr><td><strong>Response Body</strong></td><td>Die Antwort des Systems auf den Request (ebenfalls in JSON).</td></tr></tbody></table>

{% hint style="success" %}
Die Logs sind insbesondere hilfreich, wenn bei der Kommunikation zwischen nexcore und externen Systemen (z. B. ERP oder Webservice) Fehler auftreten.

Über die Kombination aus Statuscode, Request- und Response-Body lässt sich der Ursprung von Problemen meist schnell eingrenzen.
{% endhint %}

***

## Logging und Zugriff

Die Logs werden automatisch durch das System erzeugt und sind nur für Nutzer:innen mit entsprechenden Berechtigungen im Bereich Developer sichtbar.

Eine manuelle Löschung oder Veränderung der Einträge ist nicht möglich.