TracePass
Zugangsberechtigungen

Zugriffsprotokoll einer Zugangsberechtigung

Die Protokollzeilen der Berechtigung, neueste zuerst, per Cursor. Ereignisse (grant_created, grant_changed, grant_revoked) nennen, wer gehandelt hat: via ist der API-Schlüssel (mit seinem Label) oder die OAuth-App und null für das Dashboard; actorId ist der Nutzer, für den gehandelt wurde. read-Zeilen tragen eine Zahl pro Pass, Kanal und Tag.

GET/api/v1/access-grants/{id}/activity
OpenAPI 3.1 herunterladen
GET/api/v1/access-grants/{id}/activity

Zugriffsprotokoll einer Zugangsberechtigung

Die Protokollzeilen der Berechtigung, neueste zuerst, per Cursor. Ereignisse (grant_created, grant_changed, grant_revoked) nennen, wer gehandelt hat: via ist der API-Schlüssel (mit seinem Label) oder die OAuth-App und null für das Dashboard; actorId ist der Nutzer, für den gehandelt wurde. read-Zeilen tragen eine Zahl pro Pass, Kanal und Tag.

Es werden keine IP-Adressen gespeichert, Zeilen werden nach 24 Monaten gelöscht. Eine ID eines anderen Unternehmens ergibt 404.

Wer darf aufrufen. Ein API-Schlüssel nur, wenn sein Eigentümer „May manage access grants“ für diesen Schlüssel auf der Developer-Seite eingeschaltet hat (standardmäßig aus; sonst 403 access_grants_not_enabled). Ein OAuth-Token braucht den Scope access_grants:read und mindestens die Rolle Editor.

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    ID der Zugangsberechtigung.

Query-Parameter

  • limit

    integer

    Seitengröße, 1 bis 100 (Standard 50).

  • cursor

    string (24 hex chars)

    Der nextCursor der vorherigen Seite.

Header

  • Authorizationerforderlich

    string

    Bearer <token> — entweder ein tp_ API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Anfrage

curl -sS https://app.tracepass.eu/api/v1/access-grants/6650c1d2e3f4a5b6c7d8e9f0/activity \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "data": [
    {
      "id": "6650d2e3f4a5b6c7d8e9f0a1",
      "kind": "grant_created",
      "day": "2026-06-01T00:00:00.000Z",
      "channel": null,
      "passportId": null,
      "count": null,
      "detail": null,
      "actorId": "6650a0a0a0a0a0a0a0a0a0a0",
      "via": { "kind": "api_key", "keyId": "6650b0b0b0b0b0b0b0b0b0b0", "label": "SAP prod" },
      "lastAt": "2026-06-01T09:30:00.000Z"
    }
  ],
  "nextCursor": null
}