TracePass
Започнете
Паспорти

Окончателно изтриване на паспорт

**Окончателно и необратимо** — записът за паспорта плюс всички каскадно свързани зависимости се премахват от базата данни. Каскадата включва AI извличания, състояние на agent сесия, заявки към доставчици, свързани само с този паспорт, събития от сканирания + сервизни събития, и всички качени документи, чиято единствена референция е този паспорт (документи, споделени с други паспорти/продукти, остават). R2 storage под папката на паспорта също се изчиства.

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

Окончателно изтриване на паспорт

**Окончателно и необратимо** — записът за паспорта плюс всички каскадно свързани зависимости се премахват от базата данни. Каскадата включва AI извличания, състояние на agent сесия, заявки към доставчици, свързани само с този паспорт, събития от сканирания + сервизни събития, и всички качени документи, чиято единствена референция е този паспорт (документи, споделени с други паспорти/продукти, остават). R2 storage под папката на паспорта също се изчиства.

**Само непубликувани паспорти отговарят на условията.** Паспорт със статус `draft` или `in_review` и `publishedAt: null` може да бъде изтрит; всичко останало връща `409 Conflict` с поле `reason`, обясняващо политиката. Това е умишлено: защитата на отпечатаните QR кодове в обращение се запазва — паспорт, който някога е резолвирал публично, не може да бъде тихо унищожен.

**Функция за платени планове.** Endpoint връща `403 Forbidden` с `reason` на Free планове; използвайте `POST /api/v1/passports/{id}/archive` вместо това — архивирането запазва записа в одитната ви следа и работи на всеки план.

Брои се като едно v1 записване. Поддържа `Idempotency-Key`. Не се изпраща webhook (записът в `billingEvents` е следата).

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

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

    ObjectId

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

Хедъри

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

    string

    `Bearer <api-key>`.

  • Idempotency-Key

    string

    UUID v4.

Заявка

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

Отговор

{
  "message": "Passport permanently deleted",
  "summary": {
    "passportId": "6650b2c3d4e5f6a7b8c9d0e1",
    "serialNumber": "SN-001",
    "gtin": "09506000134369",
    "deletedCounts": {
      "extractions": 3,
      "agentSessions": 1,
      "serviceEvents": 0,
      "scanEvents": 0,
      "ownershipTransfers": 0,
      "supplierRequestRefsRemoved": 0,
      "supplierRequestsDeleted": 0,
      "epcisEventRefsRemoved": 0,
      "epcisEventsDeleted": 0,
      "documentRefsRemoved": 1,
      "documentsDeleted": 1,
      "r2ObjectsDeleted": 4,
      "documentR2ObjectsDeleted": 1
    },
    "dppsActiveDelta": -1
  }
}

Свързани endpoints