Steam

Abzeichen

Rufe Steam-Benutzerabzeichen ab, einschließlich XP, Level und Abschlussdetails.

Endpunkt

Dieser Endpunkt gibt die Abzeichen-Daten eines Steam-Benutzers zurück, einschließlich Abzeichen-Level, verdiente XP und Abschluss-Zeitstempel. Diese Daten waren zuvor Teil des v1 Summary-Endpunkts und sind jetzt als eigener Endpunkt verfügbar.

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

Erforderliche Parameter

steamid

string

Die Steam ID des Benutzers, dessen Abzeichen du abrufen möchtest. Akzeptiert verschiedene Steam ID Formate.

Authentifizierung

Übergib deinen API-Schlüssel als x-api-key Request-Header.

x-api-key: YourSecretAPIKey

Antwortfelder

Feld	Typ	Beschreibung
`badges`	array	Array von Badge-Objekten
`player_xp`	number	Gesamte vom Spieler verdiente XP
`player_level`	number	Aktuelles Steam-Level des Spielers
`player_xp_needed_to_level_up`	number	Benötigte XP für das nächste Level
`player_xp_needed_current_level`	number	Erforderliche XP für das aktuelle Level

Badge-Objekt

Feld	Typ	Beschreibung
`badgeid`	number	Die Badge-ID
`appid`	number	Application-ID (für spielspezifische Abzeichen, optional)
`level`	number	Aktuelles Level des Abzeichens
`completion_time`	number	Unix-Zeitstempel, wann das Abzeichen erhalten oder hochgestuft wurde
`xp`	number	Durch dieses Abzeichen verdiente XP
`scarcity`	number	Anzahl der Benutzer, die dieses Abzeichen besitzen
`communityitemid`	string	Community-Item-ID (für Spielabzeichen, optional)
`border_color`	number	Rahmenfarb-Wert (für Spielabzeichen, optional)

Antwortbeispiel

Beispielausgabe für diesen Endpunkt. Der Kürze halber wurden einige Abzeichen ausgelassen.

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

Inventar

Rufe das Steam-Inventar eines Benutzers für eine bestimmte App und einen bestimmten Kontext ab. Die Antwort enthält Assets zusammen mit den Beschreibungen, die die visuellen und marktbezogenen Metadaten jedes Assets auflösen.

Spiele

Rufe eine Liste der Spiele eines Steam-Benutzers ab, einschließlich Spielzeit-Statistiken und erweiterter App-Infos.