Grant items to users

post/v2/project/{project_id}/inventory/reward

Adds the specified items to the specified user inventories.

Attention

Only 50 operations can be processed at once. Operations that exceed this limit will be ignored.

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Default: 44056

Project ID.

Request Body schema: application/json

Array

required

object

id	string Default: "d342dad2-9d59-11e9-a384-42010aa8003f" The unique user identifier on the platform.

required

Array of objects non-empty

Array (non-empty)

sku required	string Default: "booster_mega_1" Item class identifier. The SKU may only contain lowercase Latin alphanumeric characters, periods, dashes, and underscores.
quantity required	number Default: 1 Number of items of this class needed to be granted.

comment

string [ 1 .. 255 ] characters

Default: "Monthly challenge rewards"

Operation description. For example: "Monthly challenge rewards".

platform

string

Default: "xsolla"

Publishing platform the user plays on.

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"

Responses

200

Successful user reward.

404

Item for project not found.

Request samples

application/json

[{"user": {"id": "d342dad2-9d59-11e9-a384-42010aa8003f"
},
"comment": "Monthly challenge rewards",
"platform": "playstation_network",
"items": [{"sku": "booster_mega_1",
"quantity": 1
}
]
}
]

Response samples

application/json

{"count": 2,
"operations": [{"user_id": "0125760a-6810-11e9-84c0-42010aa80029",
"platform": "xsolla",
"comment": "Quest completed",
"items": [{"sku": "boots_1",
"quantity": 5,
"balance": 5
},
{"sku": "crystal_pack_1",
"quantity": 3,
"balance": 3
}
]
},
{"user_id": "a7d10a4e-3f68-43cc-a6b2-893d2c68fd14",
"platform": "xsolla",
"comment": "Daily reward",
"items": [{"sku": "helmet_1",
"quantity": 2,
"balance": 5
},
{"sku": "minigun_1",
"quantity": 3,
"balance": 5
}
]
}
]
}