Steam
Игры
Получи список игр Steam-пользователя, включая статистику времени в игре и расширенную информацию о приложениях.
Эндпоинт
Этот endpoint возвращает список игр, принадлежащих указанному пользователю, включая статистику времени в игре и расширенную информацию о приложениях. Библиотека игр пользователя должна быть публичной, чтобы этот endpoint вернул данные.
GET /v2/steam/users/{steamid}/games
Обязательные параметры
steamid
string
Steam ID пользователя, чью библиотеку игр ты хочешь получить. Принимает различные форматы Steam ID.
Аутентификация
Включи свой API-ключ в request header x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
Ответ представляет собой массив объектов игр.
Объект игры
| Поле | Тип | Описание |
|---|---|---|
appid | number | Steam application ID игры |
name | string | Название игры |
playtime_forever | number | Общее время в игре в минутах |
playtime_2weeks | number | Время в игре за последние 2 недели в минутах (только если играл недавно) |
img_icon_url | string | Hash для построения URL иконки игры |
has_community_visible_stats | boolean | Есть ли у игры видимая статистика сообщества |
playtime_windows_forever | number | Общее время в игре на Windows в минутах |
playtime_mac_forever | number | Общее время в игре на Mac в минутах |
playtime_linux_forever | number | Общее время в игре на Linux в минутах |
playtime_deck_forever | number | Общее время в игре на Steam Deck в минутах |
rtime_last_played | number | Unix timestamp последнего запуска игры |
Поле img_icon_url содержит хеш, а не полный URL. Чтобы получить фактическое изображение иконки, скомбинируйте его с appid по следующему шаблону:
https://media.steampowered.com/steamcommunity/public/images/apps/{appid}/{img_icon_url}.jpg
Например, используя данные Counter-Strike 2 из ответа ниже:
https://media.steampowered.com/steamcommunity/public/images/apps/730/8dbc71957312bbd3baea65848b545be9eae2a355.jpg
Пример ответа
Пример вывода для этого endpoint'а. Для краткости некоторые игры были опущены.
response.json
{
"success": true,
"response": [
{
"appid": 730,
"name": "Counter-Strike 2",
"playtime_forever": 134068,
"img_icon_url": "8dbc71957312bbd3baea65848b545be9eae2a355",
"has_community_visible_stats": true,
"playtime_windows_forever": 134068,
"playtime_mac_forever": 0,
"playtime_linux_forever": 0,
"playtime_deck_forever": 0,
"rtime_last_played": 1706000000
},
{
"appid": 570,
"name": "Dota 2",
"playtime_forever": 2708,
"playtime_2weeks": 120,
"img_icon_url": "0bbb630d63262dd66d2fdd0f7d37e8661a410075",
"has_community_visible_stats": true,
"playtime_windows_forever": 2708,
"playtime_mac_forever": 0,
"playtime_linux_forever": 0,
"playtime_deck_forever": 0,
"rtime_last_played": 1706100000
}
]
}