TracePass
Паспорти

Вземане на моментна снимка на паспорт

Връща пълния архивен запис на една моментна снимка: пълният JSON-LD payload точно такъв, какъвто е бил паспортът при създаването на снимката — при публикуване или след всяка промяна на публикуван, спрян, изтекъл или архивиран паспорт — метаданните на снимката (версия, причина, actor — кой е направил промяната — и времеви печат) и повторна проверка на хеша на съдържанието. За да получите версията, валидна към дадена дата, използвайте ?at= в Списък на моментните снимки на паспорт. hashValid: false означава, че съхраненият payload е бил модифициран след като снимката е направена — признак за подправяне на данните.

GET/api/v1/passports/{id}/snapshots/{snapshotId}
Изтегли OpenAPI 3.1
GET/api/v1/passports/{id}/snapshots/{snapshotId}

Вземане на моментна снимка на паспорт

Връща пълния архивен запис на една моментна снимка: пълният JSON-LD payload точно такъв, какъвто е бил паспортът при създаването на снимката — при публикуване или след всяка промяна на публикуван, спрян, изтекъл или архивиран паспорт — метаданните на снимката (версия, причина, actor — кой е направил промяната — и времеви печат) и повторна проверка на хеша на съдържанието. За да получите версията, валидна към дадена дата, използвайте ?at= в Списък на моментните снимки на паспорт. hashValid: false означава, че съхраненият payload е бил модифициран след като снимката е направена — признак за подправяне на данните.

Флагът restorable показва дали rawFields е бил заснет по времето на снимката. Когато restorable е true, действие за възстановяване в таблото може да върне живия паспорт към тази версия поле по поле. Когато е false (или защото rawFields не е заснет, или е празен), снимката е само-доказателствена — JSON-LD все още се съхранява и може да се провери, но автоматизираното възстановяване на ниво поле не е възможно.

Изчислете хеша сами. При hashMethod: "jcs-sha256" (всяка снимка, записана след публикуването на правилото) contentHash е sha256: и малките шестнадесетични цифри на SHA-256 от UTF-8 байтовете на jsonLd, сериализиран по схемата за каноничен JSON (JSON Canonicalization Scheme, RFC 8785): членовете на обектите са подредени по име в единици код UTF-16, без интервали, а низовете и числата са записани по правилата на ECMAScript. Всяка библиотека за RFC 8785 дава същия резултат; не е нужно нищо от TracePass. Снимките с hashMethod: "sorted-json-sha256" са хеширани върху JSON с подредени ключове и без интервали, което за обикновен JSON дава същите байтове; съхраненият им хеш никога не се преизчислява. previousHash свързва снимката с предходната (вижте Списък на моментните снимки на паспорт).

Достъп на органи до минали версии. Притежател на достъп на орган може да чете по-ранните версии на паспорта на самия му адрес: добавете ?at=<ISO 8601> (с достъпа като ?access= или Authorization: Bearer pa_…), за да получите версията, действала към този момент, като HTML страница или като JSON-LD, или ?versions=1 за списъка с версии (дата, версия, contentHash, hashMethod, previousHash, причина, без съдържание) със същата оценка chain. Списъкът е странициран: limit (по подразбиране 100, най-много 1000) и cursor (nextCursor от предишната страница). Върнатата версия носи заглавията X-TracePass-Snapshot-At, X-TracePass-Version, X-TracePass-Content-Hash, X-TracePass-Hash-Method и X-TracePass-Valid-Until. Заявките с ограничен и публичен достъп пренебрегват и двата параметъра и получават текущата версия.

Обхват на наемателя: можете да четете само снимките на паспортите на вашата компания. Брои се като едно v1 четене на паспорт спрямо дневния лимит. Предайте id на снимката от стойностите entries[].id, върнати от Списък на моментните снимки на паспорт.

Параметри в пътя

  • idзадължително

    string (24 hex chars)

    ID на паспорта.

  • snapshotIdзадължително

    string (24 hex chars)

    ID на снимката (от полето entries[].id на Списък на моментните снимки на паспорт).

Хедъри

  • Authorizationзадължително

    string

    Bearer <token> — или tp_ API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

Заявка

curl -sS "https://app.tracepass.eu/api/v1/passports/6650b2c3d4e5f6a7b8c9d0e1/snapshots/65a0f1b2c3d4e5f6a7b8c9d1" \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Отговор

{
  "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"
  }
}