Steam
Oyunlar
Oynama süreleri ve genişletilmiş uygulama bilgileri dahil bir Steam kullanıcısının sahip olduğu oyunların listesini getir.
Endpoint
Bu endpoint, belirtilen kullanıcının sahip olduğu oyunların listesini döndürür; oynama süreleri istatistikleri ve genişletilmiş uygulama bilgileri dahil. Bu endpoint'in veri döndürmesi için kullanıcının oyun kütüphanesi herkese açık olmalıdır.
GET /v2/steam/users/{steamid}/games
Gerekli parametreler
steamid
string
Oyun kütüphanesini getirmek istediğin kullanıcının Steam ID'si. Çeşitli Steam ID formatlarını kabul eder.
Kimlik Doğrulama
API anahtarını x-api-key request header'ı olarak ekle.
x-api-key: YourSecretAPIKey
Yanıt alanları
Yanıt, oyun nesnelerinden oluşan bir array'dir.
Oyun nesnesi
| Alan | Tip | Açıklama |
|---|---|---|
appid | number | Oyunun Steam uygulama ID'si |
name | string | Oyunun adı |
playtime_forever | number | Dakika cinsinden toplam oynama süresi |
playtime_2weeks | number | Son 2 haftadaki oynama süresi (dakika, sadece yakın zamanda oynandıysa mevcut) |
img_icon_url | string | Oyun ikonu URL'sini oluşturmak için hash |
has_community_visible_stats | boolean | Oyunun görünür topluluk istatistiklerine sahip olup olmadığı |
playtime_windows_forever | number | Dakika cinsinden Windows'ta toplam oynama süresi |
playtime_mac_forever | number | Dakika cinsinden Mac'te toplam oynama süresi |
playtime_linux_forever | number | Dakika cinsinden Linux'ta toplam oynama süresi |
playtime_deck_forever | number | Dakika cinsinden Steam Deck'te toplam oynama süresi |
rtime_last_played | number | Oyunun en son oynandığı zamanın Unix timestamp'i |
img_icon_url alanı tam bir URL değil, bir hash içerir. Gerçek ikon görselini elde etmek için appid ile birlikte şu kalıbı kullanın:
https://media.steampowered.com/steamcommunity/public/images/apps/{appid}/{img_icon_url}.jpg
Örneğin, aşağıdaki yanıttaki Counter-Strike 2 verileriyle:
https://media.steampowered.com/steamcommunity/public/images/apps/730/8dbc71957312bbd3baea65848b545be9eae2a355.jpg
Yanıt örneği
Bu endpoint için örnek çıktı. Kısalık için bazı oyunlar çıkarıldı.
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
}
]
}