Документация Steamworks
GetHistoryCommandDetails/v0001
Возвращает сотруднику службы поддержки подробный список возможных действий по отношению к истории пользователя. Возвращаемый период включает любое событие после starttime, но до или во время endtime.

Вызывается: инструментом службы поддержки

Метод HTTP: GET
Возвращает подробный список действий, который выполнит сервер ресурсов, если эта команда будет подтверждена. Для сложных действий сотрудник службы поддержки может по своему усмотрению отключить или включить части команды. Если сотрудник службы поддержки подтвердит команду, вызывается HistoryExecuteCommand/v0001.

Параметры:

НазваниеТипОбязательно?Описание
keystringЭто ключ сервера ресурсов, который вы предоставили в настройках раздела экономики своего приложения в Steam на партнёрском сайте.
appiduint3232-битный номер приложения, к которому относятся ресурсы.
steamiduint6464-битный SteamID пользователя, для которого возвращаются ресурсы.
contextiduint6464-битный номер контекста, где находятся ресурсы.
commandstringНазвание команды, выполняемой в отношении истории.
argumentsuint32Строка с аргументами, возвращаемая для данной команды запросом GetUserHistory.

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

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

Ответ:
  • result
    • success — true, если метод успешен. Если сервер ресурсов возвращает false, будет также возвращено поле error с объяснением.
    • error — объяснение сбоя. Это сообщение будет записано в журнал ошибок, который увидеть во вкладке «Экономика» раздела «Сообщество» настроек приложения.
    • actions — массив действий, которые выполнит сервер ресурсов, если агент подтвердит команду.
      • id — номер ресурса, который будет затронут данным действием.
      • icon_url (необязательно) — иконка для данного ресурса. Изображение должно быть в формате jpeg, gif или png и быть по меньшей мере 96 на 96 пикселей. Предпочтительно gif или png, поскольку они поддерживают прозрачность.
      • name — название затронутого ресурса.
      • command — подкоманда, которую нужно выполнить в отношении ресурса. Это значение возвращается при подтверждении.
      • note (необязательно) — дополнительная информация, которую нужно показать в окне подтверждения.
      • argument (необязательно) — аргумент, который должен быть возвращён, если данное действие выбрано при подтверждении.
      • steamid (необязательно) — 64-битный SteamID пользователя, который в данный момент владеет ресурсом. Имя профиля пользователя будет показано рядом с названием ресурса.
      • optional (необязательно) — если true, у сотрудника службы поддержки будет возможность снять отметку с этого действия и пропустить его во время выполнения команды. По умолчанию — true.
      • default (необязательно) — состояние галочки в диалоговом окне подтверждения. По умолчанию — true.

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

{ "result":1, "actions": [ { "id":"2111437", "icon_url":"http://media.steampowered.com/apps/440/icons/berliners_bucket_helm.2c1288625a8ab4c16e3c804a6649254b1a9325ca.png", "name":"Berliner's Bucket Helm", "command":"Restore", "note":"Purchased" }, { "id":"2121062", "icon_url":"http://media.steampowered.com/apps/440/icons/gift_fashion.37487e85b245787048aacefe67105bbe44a20e0c.png", "name":"Manniversary Package", "command":"Delete", "note":"Timed Drop" }, ], "displaytext":"" }