Возвращает все касающиеся пользователя записи за указанный период. Возвращаемый период включает любое событие после
starttime, но до или во время
endtime.
Вызывается: инструментом службы поддержки
Метод HTTP: GET
Параметры:
| Название | Тип | Обязательно? | Описание |
|---|
| key | string | ✔ | Это ключ сервера ресурсов, который вы предоставили в настройках раздела экономики своего приложения в Steam на партнёрском сайте. |
| appid | uint32 | ✔ | 32-битный номер приложения, к которому относятся ресурсы. |
| steamid | uint64 | ✔ | 64-битный SteamID пользователя, для которого возвращаются ресурсы. |
| contextid | uint64 | ✔ | 64-битный номер контейнера контекста, для которого нужно получить ресурсы. |
| starttime | uint32 | ✔ | Время начала периода, для которого возвращается история. Выражается в секундах, прошедших с 1 января 1970 года. |
| endtime | uint32 | ✔ | Время окончания периода, для которого возвращается история. Выражается в секундах, прошедших с 1 января 1970 года. |
Возвращаемые значения
Результат этого метода кодируется в .json.
Ответ: -
result
-
success — true, если метод успешен. Если сервер ресурсов возвращает false, будет также возвращено поле error с объяснением.
-
error — объяснение сбоя. Это сообщение будет записано в журнал ошибок, который увидеть во вкладке «Экономика» раздела «Сообщество» настроек приложения.
-
transactions — массив транзакций, которые проводились с аккаунтом пользователя в данном контексте в указанный период.
-
timestamp — время события. Выражается в секундах, прошедших с 1 января 1970 года.
-
action — краткое описание транзакции.
-
actor_steamid (необязательно) — 64-битный SteamID пользователя, инициировавшего транзакцию.
-
action_steamid (необязательно) — 64-битный SteamID другого пользователя, вовлечённого в транзакцию.
-
records — массив записей о транзакции. Эти записи могут представлять собой ресурсы или любое другое изменение в контексте.
-
action — название действия, выполненного в рамках данной транзакции.
-
id (необязательно) — номер ресурса.
-
name — название ресурса, затронутого записью.
-
url — ссылка с информацией, относящейся к записи.
-
icon_url (необязательно) — иконка для данного ресурса. Изображение должно быть в формате jpeg, gif или png и быть по меньшей мере 96 на 96 пикселей. Предпочтительно gif или png, поскольку они поддерживают прозрачность. Steam предоставит сеть доставки контента (CDN) для отправки пользователям этих изображений, так что нагрузка на эти ссылки будет сравнительно невелика.
-
context_action (необязательно) — описывает, что произошло с ресурсом в контексте, в котором он оказался в результате действия. Допустимые значения — add, remove или modify.
-
prefix (необязательно) — строка, показываемая перед названием ресурса в данной записи.
-
color (необязательно) — шестнадцатеричный RGB-цвет, используемый для отображения текста параметра prefix.
-
has_details — true, если IGameInventory/SupportGetAssetHistory вернёт корректные данные для этого ресурса.
-
detail_appid (необязательно) — AppID, для которого извлекаются данные. Это может пригодиться, только если у двух игр есть общая система. По умолчанию используется тот же AppID, к которому относится история.
-
detail_context (необязательно) — 64-битный номер контекста, для которого извлекаются данные. По умолчанию — тот же самый контекст, к которому относится история.
-
commands — список команд, которые нужно показать для данной транзакции в инструменте службы поддержки.
-
name — название команды.
-
arguments — аргумент, передаваемый обратно серверу ресурсов при вызове GetHistoryCommandDetails. Сервер экономики Steam не интерпретирует эти данные. Это может быть любая информация, которая необходима для игры, чтобы идентифицировать транзакцию, в рамках которой выполняется команда.
Пример вывода
{
"result": {
"transactions": [
{
"records": [
{
"action": "Timed Drop",
"id": 559964086,
"name": "Bushwacka",
"icon_url": "http://media.steampowered.com/apps/440/icons/c_croc_knife.ae304e977e7127b3ea5ddc862614b627604489a9.png",
"prefix": "Add",
"color": "55FF55"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAHhHs04AYWN0aW9ucwAAMQACYWN0aW9uAAcAAAAHaWQA\ntl9gIQAAAAAICAgIAA=="
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAHhHs04ICAA="
}
]
,
"timestamp": 1320372088,
"action": "Timed Drop: Points: 14114"
},
{
"records": [
{
"action": "Achievement Award",
"id": 556669733,
"name": "Bombinomicon",
"icon_url": "http://media.steampowered.com/apps/440/icons/bombonomicon.6dc3119f20faa08d10161fa876c57265ae46c282.png",
"prefix": "Add",
"color": "55FF55"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAPqqsE4AYWN0aW9ucwAAMQACYWN0aW9uAAMAAAAHaWQA\nJRsuIQAAAAAICAgIAA=="
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAPqqsE4ICAA="
}
]
,
"timestamp": 1320200954,
"action": "Achievement Award: TF_HALLOWEEN_LOOT_ISLAND"
},
{
"records": [
{
"action": "Trade",
"id": 506851037,
"name": "Bushwacka",
"icon_url": "http://media.steampowered.com/apps/440/icons/c_croc_knife.ae304e977e7127b3ea5ddc862614b627604489a9.png",
"prefix": "Add",
"color": "55FF55"
},
{
"action": "Trade",
"id": 352354754,
"name": "Mann Co. Supply Crate",
"icon_url": "http://media.steampowered.com/apps/440/icons/crate.7299648976c7a022df68b7d35bf4a7cd05800855.png",
"prefix": "Remove",
"color": "FF5555"
},
{
"action": "Trade",
"id": 352354753,
"name": "Mann Co. Supply Crate",
"icon_url": "http://media.steampowered.com/apps/440/icons/crate.7299648976c7a022df68b7d35bf4a7cd05800855.png",
"prefix": "Remove",
"color": "FF5555"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wANkejU4AYWN0aW9ucwAAMQACYWN0aW9uABgAAAAHaWQA\n3e41HgAAAAAIADIAAmFjdGlvbgAiAAAAB2lkAMKBABUAAAAACAAzAAJhY3Rpb24AIgAAAAdp\nZADBgQAVAAAAAAgANAACYWN0aW9uACIAAAAHaWQAFwwBHgAAAAAIADUAAmFjdGlvbgAiAAAA\nB2lkALVwYxkAAAAACAA2AAJhY3Rpb24AIgAAAAdpZADd\/5kWAAAAAAgANwACYWN0aW9uACIA\nAAAHaWQAr8WaFgAAAAAIADgAAmFjdGlvbgAiAAAAB2lkAAe9LhcAAAAACAA5AAJhY3Rpb24A\nIgAAAAdpZABcC\/wdAAAAAAgICAgA"
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wANkejU4ICAA="
}
]
,
"timestamp": 1317871321,
"action": "Trade",
"action_steamid": 76561198007577949
},
]
,
"success": true
}
}
