Используется для доступа к информации о пользователях.
Дополнительная информация об использовании веб-API Steamworks доступна в разделе
Обзор веб-API.
GetGlobalAchievementPercentagesForApp
GET https://partner.steam-api.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/
| Название | Тип | Обязательно? | Описание |
| gameid | uint64 | ✔ | GameID игры, для которой необходимо получить информацию о процентах выполнения достижений |
Получает глобальные проценты выполнения достижений для определённого приложения.
У данного метода есть предыдущие версии, которые больше официально не поддерживаются. Они по-прежнему доступны, однако настоятельно рекомендуется использовать самую последнюю версию.
История изменений:
- Версия 2 - удаляет названия элементов из массивов
GetGlobalStatsForGame
GET https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
| Название | Тип | Обязательно? | Описание |
| key | string | ✔ | Ключ веб-API Steamworks для аутентификации издателя. |
| appid | uint32 | ✔ | AppID, для которого будут получены глобальные статистики |
| count | uint32 | ✔ | Число статистик, для которых необходимо получить данные |
| name[0] | string | ✔ | Названия статистик, для которых необходимо получить данные |
| startdate | uint32 | | Начальная дата отсчёта общих ежедневных зачётов (метка в формате UNIX-времени) |
| enddate | uint32 | | Конечная дата отсчёта общих ежедневных зачётов (метка в формате UNIX-времени) |
Получает проценты глобальной статистики для определённого приложения.
Дополнительная информация доступна в разделе
«Общие статистики».
GetNumberOfCurrentPlayers
GET https://partner.steam-api.com/ISteamUserStats/GetNumberOfCurrentPlayers/v1/
| Название | Тип | Обязательно? | Описание |
| appid | uint32 | ✔ | AppID, для которого будет получено общее число пользователей |
Получает общее число игроков, активных в данный момент в указанном приложении в Steam.
Заметьте, что пользователи, играющие без подключения к Steam, не войдут в это число.
GetPlayerAchievements
GET https://partner.steam-api.com/ISteamUserStats/GetPlayerAchievements/v1/
| Название | Тип | Обязательно? | Описание |
| key | string | ✔ | Ключ веб-API Steamworks для аутентификации пользователя. |
| steamid | uint64 | ✔ | SteamID пользователя |
| appid | uint32 | ✔ | AppID, для которого необходимо получить информацию о достижениях |
| l | string | | Язык, для которого необходимо возвратить строки |
Получает список достижений, которые указанный пользователь разблокировал в приложении.
GetSchemaForGame
GET https://partner.steam-api.com/ISteamUserStats/GetSchemaForGame/v2/
| Название | Тип | Обязательно? | Описание |
| key | string | ✔ | Ключ веб-API Steamworks для аутентификации пользователя. |
| appid | uint32 | ✔ | AppID игры |
| l | string | | Язык локализации для возвращения (английский, французский и т. д.) |
Получает полный список статистик и достижений определённой игры.
Существуют предыдущие версии данного метода, которые больше официально не поддерживаются. Они по-прежнему доступны, однако настоятельно рекомендуется использовать самую последнюю версию.
История изменений:
- Версия 2 - исправлена ошибка возвращения названия игры в формате XML.
GetUserStatsForGame
GET https://partner.steam-api.com/ISteamUserStats/GetUserStatsForGame/v2/
| Страна | Тип | Обязательно? | Описание |
| key | string | ✔ | Ключ веб-API Steamworks для аутентификации пользователя. |
| steamid | uint64 | ✔ | SteamID пользователя |
| appid | uint32 | ✔ | AppID игры |
Получает список статистик, которые указанный пользователь назначил в приложении.
Существуют предыдущие версии данного метода, которые больше официально не поддерживаются. Они по-прежнему доступны, однако настоятельно рекомендуется использовать самую последнюю версию.
История изменений:
- Версия 2 - исправлена ошибка возвращения названия игры в формате XML.
SetUserStatsForGame
POST https://partner.steam-api.com/ISteamUserStats/SetUserStatsForGame/v1/
| Название | Тип | Обязательно? | Описание |
| key | string | ✔ | Ключ веб-API Steamworks для аутентификации издателя. |
| steamid | uint64 | ✔ | SteamID пользователя |
| appid | uint32 | ✔ | AppID игры |
| count | string | ✔ | Число статистик и достижений, для которых необходимо задать значение (пары параметров название/значение) |
| name[0] | string | ✔ | Название статистики или достижения, которое необходимо задать |
| value[0] | uint32 | ✔ | Значение, которое необходимо задать |
Задаёт значение для указанного пользователя в игре.
ВНИМАНИЕ: для этого вызова требуется API-ключ издателя, владеющего указанным AppID. Поэтому этот API
ОБЯЗАТЕЛЬНО вызывать с защищённого сервера и ни при каких обстоятельствах не допускать его использование клиентами!