Возвращает цены и категории предметов, которые могут купить пользователи. Если указаны фильтры класса, результаты должны быть отфильтрованы, так чтобы возвращённые предметы имели хотя бы одну из указанных пар ключ-значение. К примеру, если указаны два фильтра
def_index/40
и
def_index/50
, должны быть возвращены только предметы со свойствами классов def_index, равными 40 или 50.
Вызывается: веб-покупками
Метод HTTP: GET
Параметры:
Название | Тип | Обязательно? | Описание |
key | string | ✔ | Это ключ сервера ресурсов, который вы предоставили в настройках раздела экономики своего приложения в Steam на партнёрском сайте. |
appid | uint32 | ✔ | 32-битный номер приложения, к которому относятся ресурсы. |
language | string | ✔ | Языковой код ISO639-1 плюс код страны ISO 3166-1 alpha-2 для языка, на котором возвращать результаты. К примеру: en_US, de_DE, zh_CN, ko_KR. По умолчанию: никакой |
currency | string | ✔ | Опциональный код валюты стандарта ISO 4217. Если указан, нужно вернуть только предметы с ценами в данной валюте. |
class_count | uint32 | ✔ | Число указанных в фильтре идентификаторов класса. |
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"
},
}
}