TracePass
Loslegen
Produkte

Produkt archivieren

Soft-Archivierung. Product.status wechselt zu archived; die Änderung ist endgültig (kein Endpoint macht sie rückgängig). Archivierte Produkte erscheinen weiterhin in GET /api/v1/products; mit status=active blenden Sie sie aus. Nur zulässig, wenn alle Pässe des Produkts archiviert sind (sonst 409) — und das Archivieren eines Produkts verhindert nicht die Erstellung neuer Pässe dagegen.

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; die Änderung ist endgültig (kein Endpoint macht sie rückgängig). Archivierte Produkte erscheinen weiterhin in GET /api/v1/products; mit status=active blenden Sie sie aus. Nur zulässig, wenn alle Pässe des Produkts archiviert sind (sonst 409) — und das Archivieren eines Produkts verhindert nicht die Erstellung neuer Pässe dagegen.

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 Tarif verfügbar, Free eingeschlossen. 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

    string (24 hex chars)

    Produkt-ID.

Header

  • Authorizationerforderlich

    string

    Bearer <token> — entweder ein tp_ API-Schlüssel (Developer → API Keys; am einfachsten, für Server-zu-Server) oder ein OAuth-2.0-Access-Token (Developer → OAuth Apps; für nutzerautorisierte Apps, scoped und widerrufbar). Die Authentication-Seite enthält den vollständigen OAuth-Flow und die Scope-Liste.

    e.g. Bearer tp_REDACTED_xxxxxxxxxxxx

  • 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