Partially update value points for items

Partially updates the number of value points for one or more items by the item’s SKU. Users receive these value points after purchasing the specified items.

Principles of updating value points:

If an item does not yet have value points, sending a non-zero value in the amount field creates them.
If an item already has value points, sending a non-zero value in the amount field updates them.
If amount is set to 0, the existing value points for that item are deleted.

Unlike the PUT method (Set value points for items), this PATCH method does not overwrite all existing value points for items in the project, it only updates the specified items. A single request can update up to 100 items. Duplicate item SKUs cannot be included in the same request.

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 Value Point 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 alphanumerische Kleinbuchstaben, Punkte, Bindestriche und Unterstriche enthalten.
amount required	integer >= 0 Anzahl der Wertpunkte.

Responses

204

Value point rewards for items were successfully updated.

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

[{"amount": 100,
"sku": "booster_1"
},
{"amount": 0,
"sku": "booster_mega"
}
]

Response samples

application/json

{"errorCode": 1020,
"errorMessage": "[0401-1020]: Error in Authentication method occurred",
"statusCode": 401
}