向用户发放商品

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

将指定商品添加到指定的用户物品库中。

注意：

一次只能处理50个操作。超出此限制的操作将被忽略。

SecuritybasicAuth

Request

path Parameters

project_id

required

integer

Default: 44056

项目ID。

Request Body schema: application/json

Array

required

object

id	string Default: "d342dad2-9d59-11e9-a384-42010aa8003f" 平台上的唯一用户标识符。

required

Array of objects non-empty

Array (non-empty)

sku required	string Default: "booster_mega_1" 商品类标识符。SKU只能包含小写英文字母、数字字符、句点、破折号和下划线。
quantity required	number Default: 1 需要发放的此类商品数。

comment

string [ 1 .. 255 ] characters

Default: "Monthly challenge rewards"

操作说明。例如：“每月挑战奖励”。

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"

Responses

200

用户奖励成功。

404

未找到项目的商品。

Request samples

application/json

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

Response samples

application/json

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