/api/v1/passports/{id}/snapshotsСписък на моментните снимки на паспорт
Връща страничен списък с моментни снимки на паспорт, от най-нов към най-стар. Снимка се записва при публикуване и след всяка промяна на публикуван, спрян, изтекъл или архивиран паспорт — стойности на полета, преводи, страни, смяна на статус, отговори на доставчици, записи от ИИ, възстановявания — когато съдържанието на паспорта действително се е променило (EN 18221:2026, т. 4.2). Всеки запис включва id на снимката, номер на версията, причина (напр. published, field_edit, status_change, baseline), кой е направил промяната (actor, когато е известно), времеви печат, хеш на съдържанието и дали хешът все още потвърждава — hashValid: false показва подправяне на данните.
Снимките носят и restorable (дали rawFields е заснет, така че е възможно възстановяване на ниво поле) и fieldCount (брой полета в rawFields, или null за само-доказателствени снимки, направени преди rawFields да е съществувал). Паспортите отпреди функцията за снимки започват със снимка baseline; историята преди нея не е записана.
Към момент във времето: добавете ?at=<ISO 8601>, за да получите единствената снимка, валидна към този момент — пълния запис плюс validFrom и validUntil (null, докато е текуща) — вместо списъка. Връща 404, ако моментът е преди първата снимка на паспорта.
Верига от хешове. Всяка снимка, записана след началото на веригата, носи previousHash — contentHash на предходната снимка (null за първата) — и hashMethod (как е изчислен contentHash: jcs-sha256, RFC 8785, или sorted-json-sha256 за по-старите снимки). Премахната, вмъкната или променена снимка къса връзката: всеки запис съобщава chainLink (ok, broken, или unchained за снимки отпреди веригата), а chain съобщава valid за цялата история и, ако не е валидна, firstBroken със снимката и причината (hash_mismatch, previous_hash_mismatch, chain_restarted). Веригата се проверява върху всички снимки на паспорта, не само върху заявената страница.
Достъп на органи до минали версии. Притежател на достъп на орган може да чете по-ранните версии на паспорта на самия му адрес: добавете ?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 четене на паспорт спрямо дневния лимит. Страницирайте с ?page (1-базиран, по подразбиране 1) и ?limit (1–100, по подразбиране 20).
Параметри в пътя
- idзадължително
string (24 hex chars)
ID на паспорта.
Query параметри
- page
integer
Номер на страница (1-базиран, по подразбиране 1).
- at
string (ISO 8601)
Връща снимката, валидна към този момент, вместо списъка.
e.g. 2026-09-29T12:00:00Z
- limit
integer
Размер на страницата (1–100, по подразбиране 20).
Хедъри
- 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?limit=5" \
-H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"Отговор
{
"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 }
}