---
title: Вземане на моментна снимка на паспорт
description: "Пълен архивен запис на снимка: JSON-LD payload към онзи момент, кой го е променил, повторна проверка на хеша и допустимост за възстановяване."
canonical: "https://www.tracepass.eu/bg/docs/get-passport-snapshot"
locale: bg
source: "https://www.tracepass.eu/bg/docs/get-passport-snapshot"
---

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

> Пълен архивен запис на снимка: JSON-LD payload към онзи момент, кой го е променил, повторна проверка на хеша и допустимост за възстановяване.

```http
GET /api/v1/passports/{id}/snapshots/{snapshotId}
```

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

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

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

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `Authorization` | header | string | yes | `Bearer <token>` — или `tp_` API ключ (Developer → API Keys; най-просто, за server-to-server), или OAuth 2.0 access token (Developer → OAuth Apps; за приложения, авторизирани от потребител, scoped и отзоваеми). Страницата Authentication съдържа пълния OAuth поток и списъка със scopes. |
| `id` | path | ObjectId | yes | ID на паспорта. |
| `snapshotId` | path | ObjectId | yes | ID на снимката (от полето entries\[\].id на Списък на моментните снимки на паспорт). |

## Examples

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

```typescript
const res = await fetch(
  `https://app.tracepass.eu/api/v1/passports/${passportId}/snapshots/${snapshotId}`,
  { headers: { Authorization: `Bearer ${process.env.TRACEPASS_API_KEY}` } },
);
const snapshot = await res.json();
// { id, version, reason, snapshotAt, contentHash, hashValid, restorable, fieldCount, jsonLd }
```

```python
import os, requests
res = requests.get(
    f"https://app.tracepass.eu/api/v1/passports/{passport_id}/snapshots/{snapshot_id}",
    headers={"Authorization": f"Bearer {os.environ['TRACEPASS_API_KEY']}"},
)
res.raise_for_status()
snapshot = res.json()  # { id, version, reason, actor?, snapshotAt, contentHash, hashValid, restorable, fieldCount, jsonLd }
```

## Responses

### 200 — Успех

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

### 404 — Не е намерен

```json
{ "error": "Snapshot not found" }
```

## Related

- [Вземане на паспорт](https://www.tracepass.eu/bg/docs/get-passport.md)
- [Списък на снимки](https://www.tracepass.eu/bg/docs/list-passport-snapshots.md)