Steam

Rozetler

XP, seviye ve tamamlanma detayları dahil Steam kullanıcı rozetlerini getir.

Endpoint

Bu endpoint, bir Steam kullanıcısının rozet verilerini döndürür; rozet seviyesi, kazanılan XP ve tamamlanma zaman damgaları dahil. Bu veriler daha önce v1 summary endpoint'inin parçasıydı ve artık özel bir endpoint olarak mevcut.

GET /v2/steam/users/{steamid}/badges

Gerekli parametreler

steamid

string

Rozetlerini 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ı

Alan	Tip	Açıklama
`badges`	array	Rozet nesneleri dizisi
`player_xp`	number	Oyuncunun kazandığı toplam XP
`player_level`	number	Oyuncunun mevcut Steam seviyesi
`player_xp_needed_to_level_up`	number	Bir sonraki seviyeye ulaşmak için gereken XP
`player_xp_needed_current_level`	number	Mevcut seviye için gereken XP

Rozet nesnesi

Alan	Tip	Açıklama
`badgeid`	number	Rozet ID'si
`appid`	number	Uygulama ID'si (oyuna özel rozetler için, opsiyonel)
`level`	number	Rozetin mevcut seviyesi
`completion_time`	number	Rozetin kazanıldığı veya seviye atladığı zamanın Unix timestamp'i
`xp`	number	Bu rozetten kazanılan XP
`scarcity`	number	Bu rozete sahip kullanıcı sayısı
`communityitemid`	string	Topluluk öğe ID'si (oyun rozetleri için, opsiyonel)
`border_color`	number	Kenarlık renk değeri (oyun rozetleri için, opsiyonel)

Yanıt örneği

Bu endpoint için örnek çıktı. Kısalık için bazı rozetler çıkarıldı.

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

Envanter

Belirli bir uygulama ve context için bir Steam kullanıcısının envanterini getir; varlıkları, her varlığın görsel ve market metadata'sını çözen description'larla birlikte döndürür.

Oyunlar

Oynama süreleri ve genişletilmiş uygulama bilgileri dahil bir Steam kullanıcısının sahip olduğu oyunların listesini getir.