Steam
Значки
Получи данные о значках Steam-пользователя, включая XP, уровень и детали получения.
Эндпоинт
Этот endpoint возвращает данные о значках Steam-пользователя, включая уровень значка, заработанный XP и временные метки получения. Раньше эти данные были частью endpoint'а summary в v1, а теперь доступны как отдельный endpoint.
GET /v2/steam/users/{steamid}/badges
Обязательные параметры
steamid
string
Steam ID пользователя, чьи значки ты хочешь получить. Принимает различные форматы Steam ID.
Аутентификация
Включи свой API-ключ в request header x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
badges | array | Массив объектов значков |
player_xp | number | Общий XP, заработанный игроком |
player_level | number | Текущий уровень Steam игрока |
player_xp_needed_to_level_up | number | XP, необходимый для достижения следующего уровня |
player_xp_needed_current_level | number | XP, необходимый для текущего уровня |
Объект значка
| Поле | Тип | Описание |
|---|---|---|
badgeid | number | ID значка |
appid | number | ID приложения (для игровых значков, опционально) |
level | number | Текущий уровень значка |
completion_time | number | Unix timestamp получения или повышения уровня значка |
xp | number | XP, заработанный за этот значок |
scarcity | number | Количество пользователей, имеющих этот значок |
communityitemid | string | ID предмета сообщества (для игровых значков, опционально) |
border_color | number | Значение цвета рамки (для игровых значков, опционально) |
Пример ответа
Пример вывода для этого endpoint'а. Для краткости некоторые значки были опущены.
response.json
{
"success": true,
"response": {
"badges": [
{
"badgeid": 13,
"level": 625,
"completion_time": 1766289028,
"xp": 875,
"scarcity": 916315
},
{
"badgeid": 1,
"appid": 730,
"level": 5,
"completion_time": 1415375204,
"xp": 500,
"communityitemid": "1111254987",
"border_color": 0,
"scarcity": 9204132
}
],
"player_xp": 23450,
"player_level": 42,
"player_xp_needed_to_level_up": 50,
"player_xp_needed_current_level": 400
}
}
Инвентарь
Получи инвентарь Steam-пользователя для указанного приложения и контекста — возвращает ассеты вместе с описаниями, которые раскрывают визуальные и рыночные метаданные каждого ассета.
Игры
Получи список игр Steam-пользователя, включая статистику времени в игре и расширенную информацию о приложениях.