Xsolla-logo

アイテムを消費する

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

クライアントエンドポイント。現在のユーザーインベントリからアイテムを消費します。

SecurityXsollaLoginUserJWT
Request
path Parameters
project_id
required
integer
Default: 44056

プロジェクトID。

query Parameters
platform
string
Default: "xsolla"

ユーザーがプレイするパブリッシングプラットフォーム。

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。SKUには、英小文字、ピリオド、ダッシュ、およびアンダースコアのみが含まれます。

quantity
required
number
Default: 1

アイテム数量。

Responses
200

ユーザーインベントリからアイテムが消費されました。

404

アイテムがまったく見つからなかったか、アイテムがインベントリに見つからなかったか、または十分ではありません(最初の数より多くを消費しようとする)。

422

quantityskuパラメータが渡されることを確認してください。

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
}