Документація Steamworks
Інтерфейс ISteamUserStats
Використовується для доступу до інформації про користувачів.

Докладнішу інформацію про використання веб-API Steamworks можна знайти ось тут.

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Мова локалізації для повернення (english, french, ukrainian тощо).

Отримує повний список статистики та досягнень для вказаної гри.

Цей метод має попередні версії, які більше офіційно не підтримуються. Вони досі доступні, але ми наполегливо рекомендуємо використовувати останню версію.
Історія змін:
  • Версія 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 гри.
countuint32✔Кількість статистик і досягнень, для яких необхідно встановити значення (пари параметрів назва-значення).
name[0]string✔Назва статистики чи досягнення для встановлення.
value[0]uint32✔Значення для встановлення.

Установлює статистику для вказаного користувача в грі.

ПРИМІТКА: для цього виклику потрібен API-ключ видавця, котрий володіє вказаним AppID. Тому цей API ОБОВ’ЯЗКОВО викликати із захищеного сервера й за жодних умов не допускати його використання клієнтами!