# 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.nexcore.de/documentation/einstellungen-and-verwaltung/developer/logs.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.