POST /give/items/{player_identifier}

端点: POST /v1/pdapi/give/items/<player_identifier>

认证: Bearer 令牌

权限: REST.Items.Give

用途

给目标玩家一个或多个物品。

无。

JSON 对象，包含 Items 物品发放数组。每个条目都需要一个 ItemID 和正数 Count。

Field	Type	Description
`Granted`	object	Counts granted by the request.

Granted object schema:

Field	Type	Description
`Items`	integer	Total item units granted.

错误响应使用以下格式:

{
    "Error": {
        "Code": "ERROR_CODE",
        "Message": "人类可读的消息",
        "详情": {}
    }
}

HTTP	错误代码	发生条件
`401`	`INVALID_TOKEN`	`Authorization` 头缺失、格式错误，或与配置的 Bearer 令牌不匹配。
`403`	`MISSING_PERMISSION`	令牌有效，但不包含此端点权限。
`400`	`INVALID_JSON`	提供了请求体，但无法解析为 JSON。
`400`	`REQUEST_FAILED`	游戏线程回调抛出异常，或共享玩家/资源解析器失败。
`500`	`REQUEST_TIMEOUT`	内部游戏线程回调未在 5 秒内完成。
`400`	`INVALID_REQUEST`	请求体不包含 `Items` 数组。
`400`	`VALIDATION_FAILED`	One or more item grants are invalid, unsupported, too large, or do not fit in inventory.
`500`	`GRANT_FAILED`	Validation passed, but the server failed while adding items to the inventory.

POST /v1/pdapi/give/items/steam_76561198012345678

{
    "Items": [
        { "ItemID": "ExplosiveBullet", "Count": 500 },
        { "ItemID": "Launcher_Default_5", "Count": 1 }
    ]
}

POST /v1/pdapi/give/items/ps5_0f4b8c2d91aa34ef

{
    "Items": [
        { "ItemID": "Money", "Count": 10000 }
    ]
}