Steam

İstatistikler

Bir Steam kullanıcısının belirli bir oyuna ait oyun içi istatistiklerini ve başarımlarını al.

Endpoint

Bu endpoint, bir Steam kullanıcısının hesabındaki belirli bir oyun için oyun içi istatistikleri ve açılmış başarımları döndürür. Kullanılabilir istatistik isimleri her oyunun stats şeması tarafından tanımlanır ve oyundan oyuna değişir.

GET   /v2/steam/users/{steamid}/stats/{appid}

Gerekli parametreler

steamid
string
İstatistiklerini getirmek istediğin kullanıcının Steam ID'si. Çeşitli Steam ID formatlarını kabul eder.
appid
number
İstatistiklerini getirmek istediğin oyunun Steam application ID'si.

Kimlik Doğrulama

API anahtarını x-api-key request header'ı olarak ekle.

x-api-key: YourSecretAPIKey

Yanıt alanları

AlanTipAçıklama
steamIDstringKullanıcının SteamID64'ü.
gamestringOyunun adı.
achievementsarrayKullanıcının bu oyunda açtığı başarımların listesi. Yalnızca açılmış başarımlar dahildir. Aşağıdaki alanlara bak.
statsarrayOyun tarafından takip edilen oyun içi istatistik kayıtlarının listesi. Aşağıdaki alanlara bak.

Başarım nesnesi

AlanTipAçıklama
namestringBaşarımın dahili tanımlayıcısı.
unlockedbooleanBu yanıtta her zaman true — burada yalnızca açılmış başarımlar döndürülür.

İstatistik nesnesi

AlanTipAçıklama
namestringİstatistiğin dahili tanımlayıcısı. İstatistik isimleri oyun tarafından tanımlanır.
valuenumberİstatistiğin mevcut değeri. İstatistiğe bağlı olarak tamsayı ya da ondalıklı sayı olabilir.

Yanıt örneği

Bu endpoint için örnek çıktı. Kısalık için çoğu başarım ve istatistik atlanmıştır.

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 }
    ]
  }
}