TracePass
Loslegen
Produkte

Produkt archivieren

Soft-Archivierung. `Product.status` wechselt zu `archived`; das Produkt verschwindet aus den Standard-Listen (mit dem `?showArchived=true`-Filter weiterhin sichtbar). Bestehende Pässe lösen weiterhin auf — Archivieren blockiert die Erstellung NEUER Pässe gegen dieses Produkt fortan, es zerstört keinen QR-Code, der bereits bei Kunden ist.

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

Produkt archivieren

Soft-Archivierung. `Product.status` wechselt zu `archived`; das Produkt verschwindet aus den Standard-Listen (mit dem `?showArchived=true`-Filter weiterhin sichtbar). Bestehende Pässe lösen weiterhin auf — Archivieren blockiert die Erstellung NEUER Pässe gegen dieses Produkt fortan, es zerstört keinen QR-Code, der bereits bei Kunden ist.

Gibt `409 Conflict` zurück, wenn ein nicht-archivierter Pass das Produkt noch referenziert — archivieren Sie zuerst jeden Pass und rufen Sie diesen Endpoint dann erneut auf. Auf jedem Bezahlplan verfügbar. Zählt als ein v1-Schreibvorgang. Unterstützt `Idempotency-Key`.

Hier gibt es kein DELETE-Verb am selben Pfad: `DELETE /api/v1/products/{id}` ist der Hard-Delete-Endpoint mit strengeren Berechtigungen (null Pässe jeglichen Status). Archivieren ist das sichere Standard-Bereinigungsverb.

Pfad-Parameter

  • iderforderlich

    ObjectId

    Produkt-ID.

Header

  • Authorizationerforderlich

    string

    `Bearer <api-key>`.

  • Idempotency-Key

    string

    UUID v4.

Anfrage

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

Antwort

{
  "_id": "6650b2c3d4e5f6a7b8c9d0e1",
  "name": "Demo product",
  "status": "archived",
  "updatedAt": "2026-05-23T17:00:00.000Z"
}

Verwandte Endpoints