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

Katalogartikel ersetzen

put

/catalogs/{catalog_name}/items

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

Wenn ein Katalogartikel nicht vorhanden ist, erstellt dieser Endpunkt den Artikel in Ihrem Katalog. Jede Anfrage kann bis zu 50 Katalogartikel enthalten. Dieser Endpunkt ist asynchron.

Fehlerbehebung

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

Fehler Fehlerbehebung
catalog-not-found Prüfen Sie, ob der Katalogname gültig ist.
company-size-limit-already-reached Das Speicherlimit für Kataloge ist erreicht. Informationen zu Speicherstufen finden Sie unter Einschränkungen bei der Datenspeicherung.
company-size-limit-surge Die Anfrage überschreitet den verbleibenden Katalogspeicher Ihres Unternehmens. Versuchen Sie es mit einem kleineren Update erneut. Informationen zu Speicherstufen finden Sie unter Einschränkungen bei der Datenspeicherung.
ids-not-strings Vergewissern Sie sich, dass jede Artikel-ID ein String ist.
ids-not-unique Prüfen Sie, ob jede Artikel-ID eindeutig ist.
ids-too-large Das Zeichenlimit für jede Artikel-ID beträgt 250 Zeichen.
items-array-is-invalid items muss ein Array von Objekten sein.
items-missing-ids Einige Artikel haben keine Artikel-IDs. Vergewissern Sie sich, dass jeder Artikel eine ID hat.
items-too-large Artikelwerte dürfen 5.000 Zeichen nicht überschreiten.
invalid-ids Zulässige Zeichen für Artikel-ID-Namen sind Buchstaben, Zahlen, Bindestriche und Unterstriche.
invalid-fields Vergewissern Sie sich, dass alle Felder, die Sie in der API-Anfrage senden, bereits im Katalog vorhanden sind. Dies hat nichts mit dem im Fehler genannten ID-Feld zu tun.
invalid-keys-in-value-object Schlüssel von Artikelobjekten dürfen weder . noch $ enthalten.
too-deep-nesting-in-value-object Artikelobjekte dürfen nicht mehr als 50 Verschachtelungsebenen haben.
request-includes-too-many-items Ihre Anfrage enthält zu viele Artikel. Das Limit pro Anfrage beträgt 50 Artikel.
unable-to-coerce-value Artikeltypen können nicht konvertiert werden.

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

New Stuff!