Xsolla-logoXsolla Developers
oder
Zum Kundenportal

Wertpunkte für Artikel teilweise aktualisierenServer-sideAdmin

patch/v2/project/{project_id}/admin/items/{value_point_sku}/value_points/rewards

Aktualisiert die Anzahl der Wertpunkte für einen oder mehrere Artikel teilweise anhand der SKU des Artikels. Nutzer erhalten Wertpunkte nach dem Kauf der angegebenen Artikel.

Grundregeln für die Aktualisierung von Wertpunkten:

  • Wenn einem Artikel noch keine Wertpunkte zugewiesen sind, werden diese durch das Senden eines Wertes ungleich Null in das Feld amount eingetragen.
  • Wenn einem Artikel bereits Wertpunkte zugewiesen sind, werden die im Feld amount angegebenen Wertpunkte durch das Senden eines Wertes ungleich Null überschrieben.
  • Wennamount auf 0 festgelgt wird, werden die vorhandenen Wertpunkte für diesen Artikel gelöscht.

Im Gegensatz zur PUT-Methode (Wertpunkte für Artikel festlegen), werden bei dieser PATCH-Methode nicht alle vorhandenen Artikel-Wertpunkte im Projekt überschrieben, sondern nur die Wertpunkte der angegebenen Artikel aktualisiert.

Mit einer einzelnen Anfrage können bis zu 100 Artikel aktualisiert werden. Doppelt vorhandene Artikel-SKUs dürfen nicht in derselben Anfrage enthalten sein.

SecuritybasicAuth
Request
path Parameters
project_id
required
integer

Projekt-ID. Dieser Parameter wird im Kundenportal neben dem Projektnamen angezeigt.

Example: 44056
value_point_sku
required
string

Wertepunkt-SKU.

Example: value_point_3
Request Body schema: application/json
Array
sku
required
string [ 1 .. 255 ] characters ^[a-zA-Z0-9_\\-–.]*$

Eindeutige Artikel-ID. Die SKU darf nur lateinische Klein- und Großbuchstaben, Ziffern, Punkte, Bindestriche und Unterstriche enthalten.

amount
required
integer >= 0

Anzahl der Wertpunkte.

Responses
204

Wertpunktbelohnungen für Artikel wurden erfolgreich aktualisiert.

401

Basisauthentifizierung nicht bestanden oder falsch. Prüfen Sie die Anmeldedaten und vergewissern Sie sich, dass Sie die Basisauthentifizierung verwenden.

404

Artikel nicht gefunden. Stellen Sie sicher, dass die project_id und die sku korrekt sind.

Request samples
application/json
[
  • {
    },
  • {
    }
]
Response samples