TracePass
Loslegen
Pässe

Pass archivieren (unumkehrbar)

**Unumkehrbar.** Der öffentliche Viewer gibt 404 zurück, die GS1-Digital-Link-URL löst nicht mehr auf, der QR-Code stirbt endgültig. Nur für Produkte verwenden, die nie ausgeliefert wurden — das Archivieren eines Passes für ein Produkt, das bereits bei Kunden ist, zerstört jeden QR-Scan, den sie je damit machen werden.

POST/api/v1/passports/{id}/archive
OpenAPI 3.1 herunterladen
POST/api/v1/passports/{id}/archive

Pass archivieren (unumkehrbar)

**Unumkehrbar.** Der öffentliche Viewer gibt 404 zurück, die GS1-Digital-Link-URL löst nicht mehr auf, der QR-Code stirbt endgültig. Nur für Produkte verwenden, die nie ausgeliefert wurden — das Archivieren eines Passes für ein Produkt, das bereits bei Kunden ist, zerstört jeden QR-Scan, den sie je damit machen werden.

Es gibt absichtlich kein DELETE-Verb: zu leicht als destruktive Aktion per Curl-Typo oder fehlkonfiguriertem Client auszulösen. Die HTTP-Methode ist POST und der Pfad enthält das literale `archive`-Segment — beides bewusste Reibung. Zählt als ein v1-Schreibvorgang. Unterstützt Idempotency-Key. Sendet den `passport.archived`-Webhook.

Pfad-Parameter

  • iderforderlich

    ObjectId

    Pass-ID.

Header

  • Authorizationerforderlich

    string

    `Bearer <api-key>`.

  • Idempotency-Key

    string

    UUID v4.

Anfrage

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

Antwort

{
  "_id": "6650b2c3d4e5f6a7b8c9d0e1",
  "status": "archived",
  "archivedAt": "2026-05-09T17:00:00.000Z"
}

Verwandte Endpoints