Steam

Osiągnięcia

Pobierz osiągnięcia użytkownika Steam dla konkretnej gry, wraz ze statusem odblokowania i timestampem.

Endpoint

Ten endpoint zwraca listę osiągnięć dla konkretnej gry na koncie użytkownika Steam, wraz z aktualnym statusem odblokowania i timestampem odblokowania dla każdego osiągnięcia.

GET   /v2/steam/users/{steamid}/achievements/{appid}

Wymagane parametry

steamid
string
Steam ID użytkownika, którego osiągnięcia chcesz pobrać. Akceptuje różne formaty Steam ID.
appid
number
Steam application ID gry, której osiągnięcia chcesz pobrać.

Uwierzytelnianie

Dołącz swój klucz API jako header x-api-key.

x-api-key: YourSecretAPIKey

Pola odpowiedzi

PoleTypOpis
steamIDstringSteamID64 użytkownika.
gamestringNazwa gry.
achievementsarrayLista obiektów osiągnięć dla tej gry. Patrz pola poniżej.

Obiekt osiągnięcia

PoleTypOpis
namestringWewnętrzny identyfikator osiągnięcia.
unlockedbooleanCzy użytkownik odblokował to osiągnięcie.
unlockedTimestampnumberUnix timestamp odblokowania osiągnięcia. 0, jeśli osiągnięcie jest zablokowane.

Przykład odpowiedzi

Przykładowy output dla tego endpointu. Dla zwięzłości większość osiągnięć została pominięta.

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