Zum Inhalt springen
View in Postman (opens in new tab)

Katalogartikel ersetzen

put

/catalogs/{catalog_name}/items/{item_id}

Verwenden Sie diesen Endpunkt, um einen Artikel in Ihrem Katalog zu ersetzen.

Wenn die item_id nicht gefunden wird, erstellt dieser Endpunkt den Artikel in Ihrem Katalog. Dieser Endpunkt ist synchron.

Fehlerbehebung

In der folgenden Tabelle sind mögliche zurückgegebene Fehler und die zugehörigen Schritte zur Fehlerbehebung aufgeführt.

Fehler Fehlerbehebung
arbitrary-error Ein unbekannter Fehler ist aufgetreten. Versuchen Sie es erneut oder wenden Sie sich an den Support.
catalog-not-found Prüfen Sie, ob der Katalogname gültig ist.
filtered-set-field-too-long Der Feldwert wird in einem gefilterten Set verwendet, das die Zeichenbegrenzung für einen Artikel überschreitet.
id-in-body Entfernen Sie alle Artikel-IDs aus dem Body der Anfrage.
ids-too-large Die Zeichenbegrenzung für jede Artikel-ID liegt bei 250 Zeichen.
invalid-ids Für Artikel-ID-Namen werden Buchstaben, Zahlen, Bindestriche und Unterstriche unterstützt.
invalid-fields Vergewissern Sie sich, dass alle Felder, die Sie in der API-Anfrage senden, bereits im Katalog vorhanden sind. Dies bezieht sich nicht auf das in der Fehlermeldung erwähnte ID-Feld.
invalid-keys-in-value-object Schlüssel von Artikelobjekten dürfen weder . noch $ enthalten.
item-already-exists Der Artikel ist bereits im Katalog vorhanden.
items-array-is-invalid items muss ein Array von Objekten sein.
items-too-large Die Zeichenbegrenzung für jeden Artikel liegt bei 5.000 Zeichen.
request-includes-too-many-items Sie können pro Anfrage nur einen Katalogartikel erstellen.
too-deep-nesting-in-value-object Artikelobjekte dürfen nicht mehr als 50 Verschachtelungsebenen haben.
unable-to-coerce-value Artikeltypen können nicht konvertiert werden.

Sie können das OpenAPI-Dokument herunterladen und es zur Validierung von Schemas verwenden. Wie das geht, erfahren Sie unter OpenAPI-Schemas zur Validierung von Anfragen verwenden.

New Stuff!