/api/v1/passports/{id}/snapshots/{snapshotId}Passport-Snapshot abrufen
Gibt den vollständigen Archiv-Datensatz für einen Unveränderlichkeits-Snapshot zurück: den vollständigen JSON-LD-Payload genau so, wie der Pass bei Erstellung des Snapshots war — bei der Veröffentlichung oder nach jeder Änderung an einem veröffentlichten, ausgesetzten, abgelaufenen oder archivierten Pass —, die Snapshot-Metadaten (Version, Grund, actor — wer die Änderung verursacht hat — und Zeitstempel) und die Content-Hash-Re-Verifizierung. Für die zu einem bestimmten Datum gültige Fassung verwenden Sie ?at= bei Passport-Snapshots auflisten. hashValid: false bedeutet, dass der gespeicherte Payload seit der Snapshot-Erstellung geändert wurde — ein Indiz für At-Rest-Manipulation.
Das restorable-Flag gibt an, ob rawFields zum Snapshot-Zeitpunkt erfasst wurde. Wenn restorable true ist, kann eine Dashboard-Wiederherstellungsaktion den Live-Pass feldgenau auf diese Version zurücksetzen. Wenn false (entweder weil rawFields nicht erfasst wurde oder leer ist), ist der Snapshot nur zur Beweisführung — das JSON-LD ist noch erhalten und verifizierbar, aber eine automatisierte feldgenaue Wiederherstellung ist nicht möglich.
Hash selbst nachrechnen. Bei hashMethod: "jcs-sha256" (jeder Snapshot, der seit Veröffentlichung der Regel geschrieben wurde) ist contentHash das Präfix sha256: gefolgt vom SHA-256 in Kleinbuchstaben-Hex über die UTF-8-Bytes von jsonLd, serialisiert nach dem JSON Canonicalization Scheme (RFC 8785): Objektmember nach Namen als UTF-16-Code-Units sortiert, ohne Leerraum, Strings und Zahlen in ECMAScript-Schreibweise. Jede RFC-8785-Bibliothek liefert dasselbe Ergebnis; von TracePass wird nichts benötigt. Snapshots mit hashMethod: "sorted-json-sha256" wurden über JSON mit sortierten Objektschlüsseln und ohne Leerraum gehasht, was bei gewöhnlichem JSON dieselben Bytes ergibt; ihr gespeicherter Hash wird nie neu berechnet. previousHash verknüpft den Snapshot mit dem davor (siehe Passport-Snapshots auflisten).
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: Sie können nur Snapshots der Pässe Ihres Unternehmens lesen. Zählt als ein v1-Pass-Lesevorgang gegen das Tageslimit. Geben Sie die Snapshot-ID aus den entries[].id-Werten an, die von Passport-Snapshots auflisten zurückgegeben werden.
Pfad-Parameter
- iderforderlich
string (24 hex chars)
Pass-ID.
- snapshotIderforderlich
string (24 hex chars)
Snapshot-ID (aus dem Feld entries[].id von Passport-Snapshots auflisten).
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/65a0f1b2c3d4e5f6a7b8c9d1" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Antwort
{
"id": "65a0f1b2c3d4e5f6a7b8c9d1",
"version": 3,
"reason": "field_edit",
"actor": "apikey:tp_89b2482d",
"snapshotAt": "2026-09-15T14:32:00.000Z",
"contentHash": "sha256:a3f1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2",
"hashMethod": "jcs-sha256",
"previousHash": "sha256:b4e2d3c5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0c1d2e3f4a5b6c7d8e9f0a1b2c3",
"hashValid": true,
"restorable": true,
"fieldCount": 142,
"jsonLd": {
"@context": "https://gs1.org/voc/",
"@type": "gs1:Product",
"gs1:productName": "Industrial Battery 48V 200Ah",
"gs1:gtin": "09506000134376"
}
}