/api/v1/passports/{id}/snapshotsPassport-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.
Hash-Kette. Jeder Snapshot, der seit Beginn der Kette geschrieben wurde, trägt previousHash, den contentHash des Snapshots davor (null beim ersten), und hashMethod (wie contentHash berechnet wurde: jcs-sha256, RFC 8785, oder sorted-json-sha256 bei älteren Snapshots). Ein entfernter, eingefügter oder geänderter Snapshot unterbricht die Verknüpfung: Jeder Eintrag meldet chainLink (ok, broken oder unchained für Snapshots aus der Zeit vor der Kette), und chain meldet valid für den gesamten Verlauf und, falls nicht gültig, firstBroken mit Snapshot und Grund (hash_mismatch, previous_hash_mismatch, chain_restarted). Die Kette wird über alle Snapshots des Passes geprüft, nicht nur über die angeforderte Seite.
Behördenzugriff auf frühere Versionen. Wer einen Behörden-Zugangsschlüssel hat, kann frühere Versionen eines Passes unter der Pass-URL selbst lesen: Mit ?at=<ISO 8601> (der Schlüssel als ?access= oder Authorization: Bearer pa_…) erhalten Sie die zu diesem Zeitpunkt gültige Version, als HTML-Seite oder als JSON-LD; mit ?versions=1 die Versionsliste (Datum, Version, contentHash, hashMethod, previousHash, Grund, ohne Inhalt) mit demselben chain-Befund. Die Liste ist seitenweise: limit (Standard 100, höchstens 1000) und cursor (der nextCursor der vorigen Seite). Eine ausgelieferte Version trägt die Header X-TracePass-Snapshot-At, X-TracePass-Version, X-TracePass-Content-Hash, X-TracePass-Hash-Method und X-TracePass-Valid-Until. Anfragen mit eingeschränktem oder öffentlichem Zugriff ignorieren beide Parameter und erhalten die aktuelle Version.
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 eintp_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": "sha256:a3f1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2",
"hashMethod": "jcs-sha256",
"previousHash": "sha256:b4e2d3c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3",
"hashValid": true,
"chainLink": "ok",
"restorable": true,
"fieldCount": 142
},
{
"id": "65a0f1b2c3d4e5f6a7b8c9d0",
"version": 1,
"reason": "published",
"snapshotAt": "2026-08-01T09:00:00.000Z",
"contentHash": "sha256:b4e2d3c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3",
"hashMethod": "sorted-json-sha256",
"hashValid": true,
"chainLink": "unchained",
"restorable": false,
"fieldCount": null
}
],
"total": 2,
"page": 1,
"limit": 20,
"totalPages": 1,
"chain": { "valid": true }
}