Zum Hauptinhalt springen

Sehen, was Ihre API-Schlüssel und Integrationen getan haben (API audit log)

Prüfen Sie jeden Aufruf, den ein API-Schlüssel oder eine OAuth-Integration an Spendesk gesendet hat: wann, welche Operation, mit welchem Schlüssel, für welche Gesellschaft und ob er erfolgreich war.

Wenn ein Tool über die API mit Spendesk verbunden ist (Ihr ERP, ein Data Warehouse, ein Skript Ihres Teams), müssen Sie manchmal wissen, was es tatsächlich getan hat: für eine Sicherheitsprüfung oder um zu verstehen, warum eine Synchronisierung fehlgeschlagen ist. Das API audit log listet die Aufrufe Ihrer API-Schlüssel und OAuth-Integrationen auf.

Dieser Artikel richtet sich an Kontoinhaber und Admins.


Das API audit log öffnen

  1. Gehen Sie zu Einstellungen → Integrationen.

  2. Öffnen Sie den Reiter API audit log.

  3. Um nur Probleme zu sehen, wählen Sie oben rechts im Filter Failed. Successful zeigt die übrigen, All requests alles.

Die neuesten Aufrufe stehen oben; mit Load more sehen Sie ältere. Ein Aufruf erscheint innerhalb einer Minute.


Was die Spalten bedeuten

Spalte

Bedeutung

Date

Zeitpunkt des Aufrufs

Auth type

API key oder OAuth2 für eine per OAuth verbundene Integration

Client / key ID

Die ID des API-Schlüssels oder OAuth-Clients, der den Aufruf gesendet hat. Ihre Schlüssel finden Sie im Reiter API management

Operation

Was angefragt wurde, zum Beispiel v1-get-suppliers (Lieferanten auflisten)

Status code

Die Antwort: 200 heißt erfolgreich; 4xx heißt abgelehnt (zum Beispiel 403, fehlende Berechtigung, oder 429, zu viele Aufrufe auf einmal); 5xx ist ein Fehler bei Spendesk

Entity

Die Gesellschaft, die der Aufruf betraf

User

Der Spendesk-Nutzer, für den der Schlüssel oder die Integration handelt

Duration

Antwortzeit von Spendesk

Correlation ID

Geben Sie sie dem Spendesk-Support, wenn Sie ein Problem mit einem Aufruf melden


Was das Log nicht zeigt

  • Aufrufe von KI-Assistenten (MCP). Was Claude, ChatGPT, Copilot oder ein anderer Assistent getan hat, steht im Action log der jeweiligen Verbindung unter Einstellungen → Integrationen → Spendesk MCP.

  • Welcher Datensatz gelesen oder geändert wurde. Das Log zeigt die Operation (zum Beispiel „Lieferant ändern“), nicht die ID des Lieferanten und nicht die gesendeten Filter.

  • Die IP-Adresse des Aufrufs.

  • Aufrufe an eine Adresse, die es in der API nicht gibt.

Hinweis: Einen Export und einen Filter nach Schlüssel oder Datum gibt es noch nicht.


Verwandte Artikel

Hat dies deine Frage beantwortet?