IGameInventory 接口（Steamworks 文献库）

Steamworks 文献库

IGameInventory 接口

Steamworks 文献库 > Steamworks Web API 索引 > IGameInventory 接口

这是与 Steam 经济体交互的主接口。
另请参见：ISteamEconomy。

请参见 Web API 概览，对如何使用 Steamworks Web API 了解更多。

GetHistoryCommandDetails

GET https://partner.steam-api.com/IGameInventory/GetHistoryCommandDetails/v1/

名称	类型	是否必需	描述
key	string	✔	Steamworks Web API 发行商验证密钥。
appid	uint32	✔	游戏的 appid。
steamid	uint64	✔	帐户操作的 Steam ID。
command	string	✔	在该资产上运行的命令。
contextid	uint64	✔	要获取历史记录的上下文。
arguments	string	✔	一开始与命令一起提供的参数。

注意： 此调用需要发行商 API 密钥以使用此方法。因此，此 API 必须通过安全服务器调用，且绝不能由客户端直接调用！

GetUserHistory

GET https://partner.steam-api.com/IGameInventory/GetUserHistory/v1/

名称	类型	是否必需	描述
key	string	✔	Steamworks Web API 发行商验证密钥。
appid	uint32	✔	游戏的 appid。
steamid	uint64	✔	要获取历史记录的 Steam ID。
contextid	uint64	✔	要获取历史记录的上下文。
starttime	uint32	✔	要获取的历史记录的开始时间。
endtime	uint32	✔	要获取的历史记录的结束时间。

注意： 此调用需要发行商 API 密钥以使用此方法。因此，此 API 必须通过安全服务器调用，且绝不能由客户端直接调用！

HistoryExecuteCommands

POST https://partner.steam-api.com/IGameInventory/HistoryExecuteCommands/v1/

名称	类型	是否必需	描述
key	string	✔	Steamworks Web API 发行商验证密钥。
appid	uint32	✔	游戏的 appid。
steamid	uint64	✔	要操作的资产 ID。
contextid	uint64	✔	要获取历史记录的上下文。
actorid	uint32	✔	供客服人员执行命令的唯一 32 位 ID。

注意： 此调用需要发行商 API 密钥以使用此方法。因此，此 API 必须通过安全服务器调用，且绝不能由客户端直接调用！

SupportGetAssetHistory

GET https://partner.steam-api.com/IGameInventory/SupportGetAssetHistory/v1/

名称	类型	是否必需	描述
key	string	✔	Steamworks Web API 发行商验证密钥。
appid	uint32	✔	游戏的 appid。
assetid	uint64	✔	要操作的资产 ID。
contextid	uint64	✔	要获取历史记录的上下文。

注意： 此调用需要发行商 API 密钥以使用此方法。因此，此 API 必须通过安全服务器调用，且绝不能由客户端直接调用！

UpdateItemDefs

POST https://partner.steam-api.com/IGameInventory/UpdateItemDefs/v0001

名称	类型	是否必需	描述
key	string	✔	Steamworks Web API 发行商验证密钥。
appid	uint32	✔	游戏的 appid。
itemdefs	JSON array	✔	待更新或创建的一个或多个物品定义，以 JSON 数组显示。

响应
此方法将以 JSON 对象输出。

响应
- success - 如果方法成功，为 true。如果资产服务器返回 false，应将 error 设置为解释原因的字符串。
- error - 描述为何此调用失败的字符串。这条消息将记录入错误日志，可在 Steamworks 站点的“经济体”选项卡下查看。
- failed - 此调用成功更新的物品定义 ID 数组。

代码示例

curl --request POST \ --header "Content-Type: application/x-www-form-urlencoded" \ --form appid=30400 \ --form 'itemdefs=[{"appid":"30400","itemdefid":"418","type":"item","display_type":"bag","name":"Bag of Stuff","description":"This bag contains stuff.","background_color":"993300","tradable": true,"marketable": true,"commodity": true,"tags":"class:human;type:bag"}, {"appid": "30400","itemdefid":"403","type":"item","display_type":"cat","name":"Cat of Bags","description":"This cat contains multitudes."}]' "https://api.steampowered.com/IGameInventory/UpdateItemDefs/v0001?key=xxxxxx"

输出示例

{ "result": { "updated": [ "418", "403" ], "failed": [], "success": true } }

物品定义全部更新完毕后，如果您修改了可出售或可交易标记，请调用 FlushAssetAppearanceCache，以立即更新市场上关联物品的状态。执行此调用时，服务器开销巨大，因此应仅在所有更新全部完毕且标记已修改后进行。