Steam
Statistiken
Rufe die In-Game-Statistiken und Erfolge eines Steam-Benutzers für ein bestimmtes Spiel ab.
Endpunkt
Dieser Endpunkt gibt die In-Game-Statistiken und die freigeschalteten Erfolge für ein bestimmtes Spiel im Account eines Steam-Benutzers zurück. Die verfügbaren Statistik-Namen werden durch das Stats-Schema des jeweiligen Spiels definiert und variieren pro Titel.
GET /v2/steam/users/{steamid}/stats/{appid}
Erforderliche Parameter
steamid
string
Die Steam ID des Benutzers, dessen Statistiken du abrufen möchtest. Akzeptiert verschiedene Steam ID Formate.
appid
number
Die Steam-Applikations-ID des Spiels, dessen Statistiken du abrufen möchtest.
Authentifizierung
Übergib deinen API-Schlüssel als x-api-key Request-Header.
x-api-key: YourSecretAPIKey
Antwortfelder
| Feld | Typ | Beschreibung |
|---|---|---|
steamID | string | Die SteamID64 des Benutzers. |
game | string | Der Name des Spiels. |
achievements | array | Liste der Erfolge, die der Benutzer in diesem Spiel freigeschaltet hat. Nur freigeschaltete Erfolge sind enthalten. Siehe Felder unten. |
stats | array | Liste der In-Game-Statistik-Einträge, die das Spiel erfasst. Siehe Felder unten. |
Erfolg-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
name | string | Der interne Bezeichner des Erfolgs. |
unlocked | boolean | In dieser Antwort immer true — hier werden nur freigeschaltete Erfolge zurückgegeben. |
Statistik-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
name | string | Der interne Bezeichner der Statistik. Statistik-Namen werden vom Spiel definiert. |
value | number | Der aktuelle Wert der Statistik. Kann je nach Statistik eine Ganzzahl oder eine Gleitkommazahl sein. |
Antwortbeispiel
Beispielausgabe für diesen Endpunkt. Zur Übersichtlichkeit wurden die meisten Erfolge und Statistiken weggelassen.
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 }
]
}
}