TracePass
Loslegen
Pässe

Passport-Snapshots auflisten

Gibt eine seitenweise Liste von Unveränderlichkeits-Snapshots eines Passes zurück, neueste zuerst. Ein Snapshot wird bei der Veröffentlichung und nach jeder Änderung eines veröffentlichten, ausgesetzten, abgelaufenen oder archivierten Passes geschrieben — Feldwerte, Übersetzungen, Beteiligte, Statuswechsel, Lieferantenantworten, KI-Schreibvorgänge, Wiederherstellungen —, sofern sich der Inhalt des Passes tatsächlich geändert hat (EN 18221:2026, 4.2). Jeder Eintrag enthält die Snapshot-ID, Versionsnummer, Grund (z. B. published, field_edit, status_change, baseline), den Verursacher (actor, sofern bekannt), Zeitstempel, Content-Hash und ob der Hash noch stimmt — hashValid: false zeigt eine At-Rest-Manipulation an.

GET/api/v1/passports/{id}/snapshots
OpenAPI 3.1 herunterladen
GET/api/v1/passports/{id}/snapshots

Passport-Snapshots auflisten

Gibt eine seitenweise Liste von Unveränderlichkeits-Snapshots eines Passes zurück, neueste zuerst. Ein Snapshot wird bei der Veröffentlichung und nach jeder Änderung eines veröffentlichten, ausgesetzten, abgelaufenen oder archivierten Passes geschrieben — Feldwerte, Übersetzungen, Beteiligte, Statuswechsel, Lieferantenantworten, KI-Schreibvorgänge, Wiederherstellungen —, sofern sich der Inhalt des Passes tatsächlich geändert hat (EN 18221:2026, 4.2). Jeder Eintrag enthält die Snapshot-ID, Versionsnummer, Grund (z. B. published, field_edit, status_change, baseline), den Verursacher (actor, sofern bekannt), Zeitstempel, Content-Hash und ob der Hash noch stimmt — hashValid: false zeigt eine At-Rest-Manipulation an.

Snapshots tragen auch restorable (ob rawFields erfasst wurde, sodass eine feldgenaue Wiederherstellung möglich ist) und fieldCount (Anzahl der Felder in rawFields, oder null für reine Beweissnapshots vor Einführung von rawFields). Pässe aus der Zeit vor den Snapshots beginnen mit einem baseline-Snapshot; Verlauf vor diesem Zeitpunkt wurde nie erfasst.

Zeitpunktabfrage: Mit ?at=<ISO 8601> erhalten Sie statt der Liste den einen Snapshot, der zu diesem Zeitpunkt gültig war — den vollständigen Datensatz plus validFrom und validUntil (null, solange aktuell). 404, wenn der Zeitpunkt vor dem ersten Snapshot des Passes liegt.

Mandanten-Scoping: Nur die Pässe Ihres Unternehmens sind sichtbar. Zählt als ein v1-Pass-Lesevorgang gegen das Tageslimit. Paginierung mit ?page (1-basiert, Standard 1) und ?limit (1–100, Standard 20).

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Pass-ID.

Query-Parameter

  • page

    integer

    Seitennummer (1-basiert, Standard 1).

  • at

    string (ISO 8601)

    Liefert statt der Liste den zu diesem Zeitpunkt gültigen Snapshot.

    e.g. 2026-09-29T12:00:00Z

  • limit

    integer

    Seitengröße (1–100, Standard 20).

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/passports/6650b2c3d4e5f6a7b8c9d0e1/snapshots?limit=5" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "entries": [
    {
      "id": "65a0f1b2c3d4e5f6a7b8c9d1",
      "version": 3,
      "reason": "republished",
      "snapshotAt": "2026-09-15T14:32:00.000Z",
      "contentHash": "a3f1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2",
      "hashValid": true,
      "restorable": true,
      "fieldCount": 142
    },
    {
      "id": "65a0f1b2c3d4e5f6a7b8c9d0",
      "version": 1,
      "reason": "published",
      "snapshotAt": "2026-08-01T09:00:00.000Z",
      "contentHash": "b4e2d3c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3",
      "hashValid": true,
      "restorable": false,
      "fieldCount": null
    }
  ],
  "total": 2,
  "page": 1,
  "limit": 20,
  "totalPages": 1
}

Verwandte Endpoints