Schnellstart

Hol dir deine Steam ID und deinen API-Schlüssel

Um mit SteamApis loszulegen, melde dich mit deinem Steam-Account an. Nach der Anmeldung geh zu deiner SteamApis-Einstellungsseite, um deine SteamID64 und deinen API-Schlüssel abzurufen. Der API-Schlüssel ist für den Zugriff auf alle API-Endpunkte notwendig.

Authentifizierung

In v2 muss dein API-Schlüssel über den Request-Header x-api-key übergeben werden. Als Fallback kannst du ihn auch als key-Query-Parameter übergeben.

const API_KEY = '1nqNbqP5JYQ9Lpw5nATfKumaxN0';

const response = await fetch('https://api.steamapis.com/v2/steam/users/76561198038526790', {
  headers: {
    'x-api-key': API_KEY
  }
});

const data = await response.json();
console.log(data);

Antwortformat

Alle v2-Endpunkte liefern Antworten in einem einheitlichen Envelope-Format zurück:

Erfolgsantwort:

{
  "success": true,
  "response": {
    // endpunktspezifische Daten
  }
}

Fehlerantwort:

{
  "success": false,
  "error": {
    "name": "BadRequestError",
    "message": "NOT_FOUND",
    "meta": null
  }
}

HTTP-Statuscodes

Alle API-Antworten werden im JSON-Format zurückgegeben. Prüfe den HTTP-Statuscode, um festzustellen, ob deine Anfrage erfolgreich war:

• 200 OK - die Anfrage war erfolgreich.
• 400 Bad Request - die Anfrage konnte nicht verstanden werden oder es fehlten erforderliche Parameter.
• 401 Unauthorized - fehlender oder ungültiger API-Schlüssel.
• 403 Forbidden - Zugriff verweigert. Dein Konto hat möglicherweise nicht genügend Guthaben oder die erforderlichen Berechtigungen.
• 404 Not Found - die angeforderte Ressource wurde nicht gefunden.
• 429 Too Many Requests - Rate-Limit überschritten.
• 500 Internal Server Error - auf unserer Seite ist etwas schiefgelaufen.

Fehlercodes

Wenn eine Anfrage fehlschlägt, enthält die Fehlerantwort ein message-Feld, um das Problem zu identifizieren: