Xsolla-logo

Consommer un objet

post/v2/project/{project_id}/user/inventory/item/consume

Endpoint client. Consomme un objet de l'inventaire actuel d'un utilisateur.

SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer
Default: 44056

ID de projet.

query Parameters
platform
string
Default: "xsolla"

Plateforme de publication sur laquelle l'utilisateur joue.

Enum: "playstation_network" "xbox_live" "xsolla" "pc_standalone" "nintendo_shop" "google_play" "app_store_ios" "android_standalone" "ios_standalone" "android_other" "ios_other" "pc_other"
Request Body schema: application/json
sku
required
string
Default: "booster_mega_1"

ID unique de l'objet. L'UGS ne peut comprendre que des caractères alphanumériques latins minuscules, des points, des tirets et des traits bas.

quantity
required
number
Default: 1

Quantité de l'objet.

Responses
200

Un objet de l'inventaire utilisateur a été consommé.

404

L'objet n'a pas été trouvé du tout ; l'objet n'a pas été trouvé dans l'inventaire ; ou il n'y a pas suffisamment d'unités de l'objet (tentative de consommer plus que la quantité initiale disponible).

422

Assurez-vous que les paramètres quantity et sku sont passés.

Request samples
application/json
{
  • "quantity": 1,
  • "sku": "booster_mega_1"
}
Response samples
{
  • "errorCode": 4001,
  • "errorMessage": "[0401-4001]: Item with Project Id = 44056 and Sku = gun_5 not found",
  • "statusCode": 404
}