/api/v1/passports/{id}/snapshots/{snapshotId}Ottenere uno snapshot del passaporto
Restituisce il registro archivistico completo per uno snapshot di immutabilità: l'intero payload JSON-LD esattamente com'era il passaporto quando è stato acquisito lo snapshot — alla pubblicazione o dopo ogni modifica di un passaporto pubblicato, sospeso, scaduto o archiviato — i metadati dello snapshot (versione, motivo, actor — chi ha causato la modifica — e timestamp) e la ri-verifica dell'hash del contenuto. Per ottenere la versione valida a una certa data, usare ?at= in Elencare gli snapshot del passaporto. hashValid: false significa che il payload memorizzato è stato modificato dopo che lo snapshot è stato acquisito — indicativo di manomissione at-rest.
Il flag restorable indica se rawFields è stato catturato al momento dello snapshot. Quando restorable è true, un'azione di ripristino dalla dashboard può riportare il passaporto live a questa versione campo per campo. Quando è false (perché rawFields non è stato catturato, o è vuoto), lo snapshot è solo di evidenza — il JSON-LD è ancora preservato e verificabile, ma un ripristino automatizzato a livello di campo non è possibile.
Ricalcolare l'hash in autonomia. Per hashMethod: "jcs-sha256" (ogni snapshot scritto dopo la pubblicazione della regola), contentHash è sha256: seguito dallo SHA-256 in esadecimale minuscolo dei byte UTF-8 di jsonLd, serializzato con la JSON Canonicalization Scheme (RFC 8785): membri degli oggetti ordinati per nome in unità di codice UTF-16, senza spazi, stringhe e numeri scritti secondo ECMAScript. Qualsiasi libreria RFC 8785 produce lo stesso risultato; non serve nulla di TracePass. Gli snapshot con hashMethod: "sorted-json-sha256" sono stati sottoposti a hash su JSON con chiavi degli oggetti ordinate e senza spazi, che per un JSON ordinario dà gli stessi byte; il loro hash memorizzato non viene mai ricalcolato. previousHash collega lo snapshot a quello precedente (vedere Elencare gli snapshot del passaporto).
Accesso delle autorità alle versioni passate. Chi ha un accesso di autorità può leggere le versioni precedenti di un passaporto sull'URL del passaporto stesso: aggiungendo ?at=<ISO 8601> (con l'accesso come ?access= o Authorization: Bearer pa_…) si ottiene la versione in vigore in quel momento, come pagina HTML o come JSON-LD; con ?versions=1 l'elenco delle versioni (data, versione, contentHash, hashMethod, previousHash, motivo, senza contenuto) con lo stesso esito chain. L'elenco è paginato: limit (default 100, al massimo 1000) e cursor (il nextCursor della pagina precedente). Una versione servita porta gli header X-TracePass-Snapshot-At, X-TracePass-Version, X-TracePass-Content-Hash, X-TracePass-Hash-Method e X-TracePass-Valid-Until. Le richieste con accesso limitato o pubblico ignorano entrambi i parametri e ricevono la versione corrente.
Scoped per tenant: puoi leggere solo gli snapshot dei passaporti della tua azienda. Conta come una lettura v1 passaporto contro il limite giornaliero. Fornisci l'ID dello snapshot dai valori entries[].id restituiti da Elencare gli snapshot del passaporto.
Parametri di percorso
- idobbligatorio
string (24 hex chars)
ID del passaporto.
- snapshotIdobbligatorio
string (24 hex chars)
ID dello snapshot (dal campo entries[].id di Elencare gli snapshot del passaporto).
Header
- Authorizationobbligatorio
string
Bearer <token>— una chiave APItp_(Developer → API Keys; più semplice, per server-to-server) oppure un access token OAuth 2.0 (Developer → OAuth Apps; per app autorizzate dall'utente, scoped e revocabili). La pagina Authentication contiene il flusso OAuth completo e l'elenco degli scopes.e.g. Bearer tp_REDACTED_xxxxxxxxxxxx
Richiesta
curl -sS "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/snapshots/65a0f1b2c3d4e5f6a7b8c9d1" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Risposta
{
"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"
}
}