Документация Steamworks
Интерфейс ISteamUserStats
Используется для доступа к информации о пользователях.

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

GetGlobalAchievementPercentagesForApp

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/
НазваниеТипОбязательно?Описание
gameiduint64✔GameID игры, для которой необходимо получить информацию о процентах выполнения достижений

Получает глобальные проценты выполнения достижений для определённого приложения.

У данного метода есть предыдущие версии, которые больше официально не поддерживаются. Они по-прежнему доступны, однако настоятельно рекомендуется использовать самую последнюю версию.
История изменений:
  • Версия 2 - удаляет названия элементов из массивов

GetGlobalStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
НазваниеТипОбязательно?Описание
keystring✔Ключ веб-API Steamworks для аутентификации издателя.
appiduint32✔AppID, для которого будут получены глобальные статистики
countuint32✔Число статистик, для которых необходимо получить данные
name[0]string✔Названия статистик, для которых необходимо получить данные
startdateuint32Начальная дата отсчёта общих ежедневных зачётов (метка в формате UNIX-времени)
enddateuint32Конечная дата отсчёта общих ежедневных зачётов (метка в формате UNIX-времени)

Получает проценты глобальной статистики для определённого приложения.

Дополнительная информация доступна в разделе «Общие статистики».

GetNumberOfCurrentPlayers

GET https://partner.steam-api.com/ISteamUserStats/GetNumberOfCurrentPlayers/v1/
НазваниеТипОбязательно?Описание
appiduint32✔AppID, для которого будет получено общее число пользователей

Получает общее число игроков, активных в данный момент в указанном приложении в Steam.

Заметьте, что пользователи, играющие без подключения к Steam, не войдут в это число.

GetPlayerAchievements

GET https://partner.steam-api.com/ISteamUserStats/GetPlayerAchievements/v1/
НазваниеТипОбязательно?Описание
keystring✔Ключ веб-API Steamworks для аутентификации пользователя.
steamiduint64✔SteamID пользователя
appiduint32✔AppID, для которого необходимо получить информацию о достижениях
lstringЯзык, для которого необходимо возвратить строки

Получает список достижений, которые указанный пользователь разблокировал в приложении.

GetSchemaForGame

GET https://partner.steam-api.com/ISteamUserStats/GetSchemaForGame/v2/
НазваниеТипОбязательно?Описание
keystring✔Ключ веб-API Steamworks для аутентификации пользователя.
appiduint32✔AppID игры
lstringЯзык локализации для возвращения (английский, французский и т. д.)

Получает полный список статистик и достижений определённой игры.

Существуют предыдущие версии данного метода, которые больше официально не поддерживаются. Они по-прежнему доступны, однако настоятельно рекомендуется использовать самую последнюю версию.
История изменений:
  • Версия 2 - исправлена ошибка возвращения названия игры в формате XML.

GetUserStatsForGame

GET https://partner.steam-api.com/ISteamUserStats/GetUserStatsForGame/v2/
СтранаТипОбязательно?Описание
keystring✔Ключ веб-API Steamworks для аутентификации пользователя.
steamiduint64✔SteamID пользователя
appiduint32✔AppID игры

Получает список статистик, которые указанный пользователь назначил в приложении.

Существуют предыдущие версии данного метода, которые больше официально не поддерживаются. Они по-прежнему доступны, однако настоятельно рекомендуется использовать самую последнюю версию.
История изменений:
  • Версия 2 - исправлена ошибка возвращения названия игры в формате XML.

SetUserStatsForGame

POST https://partner.steam-api.com/ISteamUserStats/SetUserStatsForGame/v1/
НазваниеТипОбязательно?Описание
keystring✔Ключ веб-API Steamworks для аутентификации издателя.
steamiduint64✔SteamID пользователя
appiduint32✔AppID игры
countstring✔Число статистик и достижений, для которых необходимо задать значение (пары параметров название/значение)
name[0]string✔Название статистики или достижения, которое необходимо задать
value[0]uint32✔Значение, которое необходимо задать

Задаёт значение для указанного пользователя в игре.

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