Steam
Gry
Pobierz listę gier użytkownika Steam ze statystykami czasu gry i szczegółami aplikacji.
Endpoint
Ten endpoint zwraca listę gier posiadanych przez wskazanego użytkownika, ze statystykami czasu gry i rozszerzonymi informacjami o aplikacji. Biblioteka gier użytkownika musi być ustawiona jako publiczna, żeby ten endpoint zwrócił dane.
GET /v2/steam/users/{steamid}/games
Wymagane parametry
steamid
string
Steam ID użytkownika, którego bibliotekę gier chcesz pobrać. Akceptuje różne formaty Steam ID.
Uwierzytelnianie
Dołącz swój klucz API jako header x-api-key.
x-api-key: YourSecretAPIKey
Pola odpowiedzi
Odpowiedź to tablica obiektów gier.
Obiekt gry
| Pole | Typ | Opis |
|---|---|---|
appid | number | Steam application ID gry |
name | string | Nazwa gry |
playtime_forever | number | Łączny czas gry w minutach |
playtime_2weeks | number | Czas gry w ostatnich 2 tygodniach w minutach (tylko jeśli grano ostatnio) |
img_icon_url | string | Hash do konstruowania URL-a ikony gry |
has_community_visible_stats | boolean | Czy gra ma widoczne statystyki społeczności |
playtime_windows_forever | number | Łączny czas gry na Windows w minutach |
playtime_mac_forever | number | Łączny czas gry na Mac w minutach |
playtime_linux_forever | number | Łączny czas gry na Linux w minutach |
playtime_deck_forever | number | Łączny czas gry na Steam Deck w minutach |
rtime_last_played | number | Unix timestamp ostatniej rozgrywki |
Pole img_icon_url zawiera hash, a nie pełny URL. Aby uzyskać rzeczywisty obraz ikony, połącz go z appid według tego wzoru:
https://media.steampowered.com/steamcommunity/public/images/apps/{appid}/{img_icon_url}.jpg
Na przykład, używając danych Counter-Strike 2 z poniższej odpowiedzi:
https://media.steampowered.com/steamcommunity/public/images/apps/730/8dbc71957312bbd3baea65848b545be9eae2a355.jpg
Przykład odpowiedzi
Przykładowy output dla tego endpointu. Dla zwięzłości niektóre gry zostały pominięte.
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
}
]
}