Steam
Статистика
Получи внутриигровую статистику и достижения Steam-пользователя для конкретной игры.
Эндпоинт
Этот endpoint возвращает внутриигровую статистику и разблокированные достижения для конкретной игры в аккаунте Steam-пользователя. Доступные имена стат определяются схемой stats каждой игры и различаются от тайтла к тайтлу.
GET /v2/steam/users/{steamid}/stats/{appid}
Обязательные параметры
steamid
string
Steam ID пользователя, чью статистику ты хочешь получить. Принимает различные форматы Steam ID.
appid
number
Steam application ID игры, статистику которой ты хочешь получить.
Аутентификация
Включи свой API-ключ в request header x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
steamID | string | SteamID64 пользователя. |
game | string | Название игры. |
achievements | array | Список достижений, которые пользователь разблокировал в этой игре. Включены только разблокированные достижения. См. поля ниже. |
stats | array | Список записей внутриигровой статистики, которые отслеживает игра. См. поля ниже. |
Объект достижения
| Поле | Тип | Описание |
|---|---|---|
name | string | Внутренний идентификатор достижения. |
unlocked | boolean | В этом ответе всегда true — здесь возвращаются только разблокированные достижения. |
Объект статистики
| Поле | Тип | Описание |
|---|---|---|
name | string | Внутренний идентификатор статистики. Имена стат определяются игрой. |
value | number | Текущее значение статистики. В зависимости от статистики может быть целым числом или числом с плавающей точкой. |
Пример ответа
Пример вывода для этого endpoint'а. Для краткости большинство достижений и стат опущено.
response.json
{
"success": true,
"result": {
"steamID": "76561198038526790",
"game": "Rust",
"achievements": [
{ "name": "COLLECT_100_WOOD", "unlocked": true },
{ "name": "COLLECT_200_STONE", "unlocked": true },
{ "name": "CONSTRUCT_BASE", "unlocked": true }
],
"stats": [
{ "name": "deaths", "value": 121 },
{ "name": "bullet_fired", "value": 6473 },
{ "name": "kill_player", "value": 67 },
{ "name": "harvest.wood", "value": 90397 },
{ "name": "comfort_duration", "value": 11709.4150390625 }
]
}
}