Интерфейс IGameInventory (документация Steamworks)

Документация Steamworks

Интерфейс IGameInventory

Документация Steamworks > Справочник по веб-API Steamworks > Интерфейс IGameInventory

Основной интерфейс для взаимодействия с системой экономики Steam.
См. также: ISteamEconomy.

Дополнительная информация об использовании веб-API Steamworks доступна в разделе Обзор веб-API.

GetHistoryCommandDetails

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

Название	Тип	Обязательно?	Описание
key	string	✔	Ключ веб-API Steamworks для аутентификации издателя.
appid	uint32	✔	AppID игры
steamid	uint64	✔	SteamID используемого аккаунта
command	string	✔	Команда, выполняемая по отношению к предмету
contextid	uint64	✔	Контекст, историю которого необходимо получить
arguments	string	✔	Аргументы, изначально предоставленные вместе с командой

ВНИМАНИЕ: этот вызов требует наличие API-ключа издателя. Поэтому этот API ОБЯЗАТЕЛЬНО вызывать с защищённого сервера и ни при каких обстоятельствах не допускать его использование клиентами!

GetUserHistory

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

Название	Тип	Обязательно?	Описание
key	string	✔	Ключ веб-API Steamworks для аутентификации издателя.
appid	uint32	✔	AppID игры
steamid	uint64	✔	SteamID, историю которого необходимо получить
contextid	uint64	✔	Контекст, историю которого необходимо получить
starttime	uint32	✔	Время начала диапазона
endtime	uint32	✔	Время окончания диапазона

HistoryExecuteCommands

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

Название	Тип	Обязательно?	Описание
key	string	✔	Ключ веб-API Steamworks для аутентификации издателя.
appid	uint32	✔	AppID игры
steamid	uint64	✔	ID ресурса используемого предмета
contextid	uint64	✔	Контекст, историю которого необходимо получить
actorid	uint32	✔	Уникальный 32-битный ID сотрудника службы поддержки, выполняющего команду

SupportGetAssetHistory

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

Название	Тип	Обязательно?	Описание
key	string	✔	Ключ веб-API Steamworks для аутентификации издателя.
appid	uint32	✔	AppID игры
assetid	uint64	✔	ID ресурса используемого предмета
contextid	uint64	✔	Контекст, историю которого необходимо получить

UpdateItemDefs

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

Название	Тип	Обязательно?	Описание
key	string	✔	Ключ веб-API Steamworks для аутентификации издателя.
appid	uint32	✔	AppID игры
itemdefs	массив JSON	✔	Одно или несколько определений предметов в виде массива JSON, которые нужно создать или обновить.

Ответ:
результатом этого метода будет объект JSON.

ответ
- success — true, если метод успешен. Если сервер ресурсов возвращает false, будет также возвращено поле error с объяснением.
- error — объяснение сбоя. Это сообщение будет записано в журнал ошибок, который можно увидеть во вкладке «Экономика» раздела «Сообщество» настроек приложения.
- failed - массив номеров определений предметов, обновлённых посредством этого вызова.

Пример кода

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, чтобы немедленно обновить статус связанных предметов на Торговой площадке. Этот вызов совершает ресурсоёмкую серверную операцию, поэтому его необходимо сделать только после завершения всех обновлений и лишь тогда, когда все эти флаги были изменены.