Steam
Erfolge
Rufe die Erfolge eines Steam-Benutzers für ein bestimmtes Spiel ab, inklusive Freischaltstatus und Zeitstempel.
Endpunkt
Dieser Endpunkt gibt die Liste der Erfolge für ein bestimmtes Spiel im Account eines Steam-Benutzers zurück, mit dem aktuellen Freischaltstatus und dem Zeitstempel der Freischaltung für jeden Erfolg.
GET /v2/steam/users/{steamid}/achievements/{appid}
Erforderliche Parameter
steamid
string
Die Steam ID des Benutzers, dessen Erfolge du abrufen möchtest. Akzeptiert verschiedene Steam ID Formate.
appid
number
Die Steam-Applikations-ID des Spiels, dessen Erfolge 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 Erfolg-Objekte für dieses Spiel. Siehe Felder unten. |
Erfolg-Objekt
| Feld | Typ | Beschreibung |
|---|---|---|
name | string | Der interne Bezeichner des Erfolgs. |
unlocked | boolean | Ob der Benutzer diesen Erfolg freigeschaltet hat. |
unlockedTimestamp | number | Unix-Zeitstempel der Freischaltung. 0, wenn der Erfolg noch gesperrt ist. |
Antwortbeispiel
Beispielausgabe für diesen Endpunkt. Zur Übersichtlichkeit wurden die meisten Erfolge weggelassen.
response.json
{
"success": true,
"result": {
"steamID": "76561198038526790",
"game": "Rust",
"achievements": [
{
"name": "COLLECT_100_WOOD",
"unlocked": true,
"unlockedTimestamp": 1666118306
},
{
"name": "COLLECT_200_STONE",
"unlocked": true,
"unlockedTimestamp": 1666119743
},
{
"name": "CRAFT_CAMPFIRE",
"unlocked": false,
"unlockedTimestamp": 0
}
]
}
}