TracePass
Loslegen
Produkte

Produkt aktualisieren

Patcht ein oder mehrere Produktfelder. Senden Sie nur die Schlüssel, die Sie ändern möchten — ausgelassene Felder bleiben unverändert. Die Ganz-Array-Semantik von imageUrls ist beabsichtigt: Das Kunden-CMS ist die kanonische Bildquelle, also ersetzt ein PATCH mit imageUrls: ["a","b"] die vorhandene Liste. Zum Anhängen eines einzelnen Bildes ohne Umschreiben nutzen Sie den Multipart-Upload-Endpoint.

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

Produkt aktualisieren

Patcht ein oder mehrere Produktfelder. Senden Sie nur die Schlüssel, die Sie ändern möchten — ausgelassene Felder bleiben unverändert. Die Ganz-Array-Semantik von imageUrls ist beabsichtigt: Das Kunden-CMS ist die kanonische Bildquelle, also ersetzt ein PATCH mit imageUrls: ["a","b"] die vorhandene Liste. Zum Anhängen eines einzelnen Bildes ohne Umschreiben nutzen Sie den Multipart-Upload-Endpoint.

Zählt als ein v1-Schreibvorgang. Unterstützt Idempotency-Key. Die model-Eindeutigkeit wird bei Änderung erneut geprüft; description: null löscht die Beschreibung (anders als das Auslassen des Schlüssels).

Pfad-Parameter

  • iderforderlich

    string (24 hex chars)

    Produkt-ID.

    e.g. 6650a1b2c3d4e5f6a7b8c9d0

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.

Body-Felder

  • name

    string (1-200)

    Anzeigename.

  • model

    string (1-100)

    Modellbezeichnung. Eindeutigkeit wird bei Änderung erneut geprüft.

  • description

    string | null (≤ 2000)

    null zum Löschen senden.

  • defaultFieldValues

    object

    Ersetzt die Seed-Werte für zukünftige Pässe. Jeder Wert wird gegen die Vorlage geprüft: Ein numerischer String in einem Zahlenfeld wird als Zahl gespeichert, jeder andere Wert, den die Vorlage ablehnt, liefert 400 Invalid default field values mit details.

  • imageUrls

    string[] (max 20)

    Ersetzt das gesamte Bild-Array.

  • sourceLocale

    string (ISO 639-1)

    Aktualisiert den Locale von name / description.

Anfrage

curl -sS -X PATCH \
  https://app.tracepass.eu/api/v1/products/6650a1b2c3d4e5f6a7b8c9d0 \
  -H "Authorization: Bearer tp_REDACTED_xxxxxxxxxxxx" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Li-Ion 48V Battery Pack (revised)",
    "imageUrls": ["https://cdn.example.com/new-hero.jpg"]
  }'

Antwort

{
  "_id": "6650a1b2c3d4e5f6a7b8c9d0",
  "name": "Li-Ion 48V Battery Pack (revised)",
  "imageUrls": ["https://cdn.example.com/new-hero.jpg"],
  "updatedAt": "2026-05-09T15:30:00.000Z"
}

Verwandte Endpoints