TracePass
Loslegen
Produkte

Produkt dauerhaft löschen

Dauerhaft und unumkehrbar. Entfernt die Produkt-Zeile + alle hochgeladenen Dokumente, deren einzige Referenz dieses Produkt war (Dokumente, die mit anderen Produkten/Pässen verknüpft sind, bleiben erhalten, nur ohne productId). Gespeicherte Dateien, die nur zu diesem Produkt gehörten, werden ebenfalls gelöscht.

DELETE/api/v1/products/{id}
OpenAPI 3.1 herunterladen
DELETE/api/v1/products/{id}

Produkt dauerhaft löschen

Dauerhaft und unumkehrbar. Entfernt die Produkt-Zeile + alle hochgeladenen Dokumente, deren einzige Referenz dieses Produkt war (Dokumente, die mit anderen Produkten/Pässen verknüpft sind, bleiben erhalten, nur ohne productId). Gespeicherte Dateien, die nur zu diesem Produkt gehörten, werden ebenfalls gelöscht.

Nur Produkte mit NULL Pässen jeglichen Status sind berechtigt — einschließlich archivierter. Gibt 409 Conflict mit der Live-Passzahl in reason zurück, wenn nicht berechtigt. Die Regel bewahrt die Audit-Historie: Ein archivierter Pass trägt die regulatorische Geschichte ("wir haben dies veröffentlicht, dann zurückgezogen"), die verwaist wäre, wenn das übergeordnete Produkt verschwindet.

Bezahlplan-Funktion. Gibt auf Free-Plänen 403 Forbidden zurück; verwenden Sie stattdessen POST /api/v1/products/{id}/archive — Archivieren behält die Zeile für Audit und funktioniert auf jedem Plan.

Zählt als ein v1-Schreibvorgang. Unterstützt Idempotency-Key. Kein Webhook; die Löschung wird in der Audit-Spur Ihres Kontos festgehalten.

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 DELETE \
  https://app.tracepass.eu/api/v1/products/6650b2c3d4e5f6a7b8c9d0e1 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx"

Antwort

{
  "message": "Product permanently deleted",
  "summary": {
    "productId": "6650b2c3d4e5f6a7b8c9d0e1",
    "name": "Demo product",
    "deletedCounts": {
      "documentRefsUnlinked": 2,
      "documentsDeleted": 1,
      "filesDeleted": 4
    }
  }
}

Verwandte Endpoints