Документация Steamworks
GetAssetPrices/v0001
Возвращает цены и категории предметов, которые могут купить пользователи. Если указаны фильтры класса, результаты должны быть отфильтрованы, так чтобы возвращённые предметы имели хотя бы одну из указанных пар ключ-значение. К примеру, если указаны два фильтра def_index/40 и def_index/50, должны быть возвращены только предметы со свойствами классов def_index, равными 40 или 50.

Вызывается: веб-покупками

Метод HTTP: GET

Параметры:

НазваниеТипОбязательно?Описание
keystringЭто ключ сервера ресурсов, который вы предоставили в настройках раздела экономики своего приложения в Steam на партнёрском сайте.
appiduint3232-битный номер приложения, к которому относятся ресурсы.
languagestringЯзыковой код ISO639-1 плюс код страны ISO 3166-1 alpha-2 для языка, на котором возвращать результаты. К примеру: en_US, de_DE, zh_CN, ko_KR. По умолчанию: никакой
currencystringОпциональный код валюты стандарта ISO 4217. Если указан, нужно вернуть только предметы с ценами в данной валюте.
class_countuint32Число указанных в фильтре идентификаторов класса.
class_name#stringНазвание идентификатора фильтра. Для каждого числа между 0 и class_count – 1 будет возвращён свой параметр (к примеру, class_name0, class_name1, class_name2).
class_value#stringЗначение идентификатора фильтра. Для каждого числа между 0 и class_count – 1 будет возвращён свой параметр (к примеру, class_value0, class_value1, class_value2).

Возвращаемые значения

Результат этого метода кодируется в .json.

Ответ:
  • result
    • success — true, если метод успешен. Если сервер ресурсов возвращает false, будет также возвращено поле error с объяснением.
    • error — объяснение сбоя. Это сообщение будет записано в журнал ошибок, который увидеть во вкладке «Экономика» раздела «Сообщество» настроек приложения.
    • assets — массив ресурсов, доступных для покупки.
      • name — название ресурса. Это название будет передано в StartWebAssetTransaction/v0001.
      • prices — должно содержать дочерний элемент для каждой поддерживаемой валюты, кроме случаев, когда валюта была указана в фильтре. Тогда в ответ должны быть включены цены только в этой валюте. Каждый дочерний ключ — код валюты стандарта ISO 4217. Значение должно быть выражено в виде целого числа без знака (unsigned integer). О том, в каком формате отправлять это значение см. Поддерживаемые валюты.
      • original_prices — если предмет продаётся во время распродажи, это поле должно содержать обычные цены в том же формате, что и prices. Поле должно быть пропущено, если предмет не участвует в распродаже.
      • class — массив идентификаторов классов ресурсов, заданных в игре. О том, каков формат идентификаторов класса см. GetContextContents/v0001.
      • tags — массив меток или категорий, относящихся к предмету. Дополнительная информация доступна в примере вывода. Массив tags в разделе result должен содержать локализованное название, показываемое для каждой метки.
    • tags — содержит дочерний элемент для каждой поддерживаемой метки, вне зависимости от указанных фильтров. Значения должны быть локализованным текстом, если указан языковой параметр, либо токеном локализации или другим идентификатором, если язык не указан.

Пример вывода

Вывод здесь приведён для запроса со следующими параметрами:
language=english&class_count=3&class_name0=def_index&class_value0=5021&class_name1=def_index&class_value1=58&class_name2=def_index&class_value2=647
{ "result": { "success": true "assets": [ { "name": "5021", "prices": { "USD": 249, "GBP": 199, "EUR": 199, "RUB": 7400 }, "class": [ { "name": "def_index", "value": "5021" } ] , "tags": [ "Tools" ] }, { "name": "58", "prices": { "USD": 74, "GBP": 44, "EUR": 55, "RUB": 2250 }, "original_prices": { "USD": 99, "GBP": 59, "EUR": 74, "RUB": 3000 }, "class": [ { "name": "def_index", "value": "58" } ] , "tags": [ "Weapons" ] }, { "name": "647", "prices": { "USD": 749, "GBP": 499, "EUR": 549, "RUB": 22400 }, "class": [ { "name": "def_index", "value": "647" } ] , "tags": [ "New", "Misc" ] } ] , "tags": { "Headgear": "Hats", "Misc": "Misc", "Weapons": "Weapons", "Tools": "Tools", "Collections": "Collections", "Bundles": "Bundles", "Maps": "Maps", "New": "New Releases" }, } }