TracePass
Loslegen
Pässe

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.

GET/api/v1/passports/{id}/snapshots/{snapshotId}
OpenAPI 3.1 herunterladen
GET/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.

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

    ObjectId

    Pass-ID.

  • snapshotIderforderlich

    ObjectId

    Snapshot-ID (aus dem Feld entries[].id von Passport-Snapshots auflisten).

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/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": "a3f1c2d4e5b6a7c8d9e0f1a2b3c4d5e6f7a8b9c0d1e2f3a4b5c6d7e8f9a0b1c2",
  "hashValid": true,
  "restorable": true,
  "fieldCount": 124,
  "jsonLd": {
    "@context": "https://gs1.org/voc/",
    "@type": "gs1:Product",
    "gs1:productName": "Industrial Battery 48V 200Ah",
    "gs1:gtin": "09506000134376"
  }
}

Verwandte Endpoints