Służy do uzyskiwania dostępu do informacji o użytkownikach.
Aby dowiedzieć się więcej o korzystaniu z API webowych Steamworks, przejdź do
omówienia API webowych.
GetGlobalAchievementPercentagesForApp
GET https://partner.steam-api.com/ISteamUserStats/GetGlobalAchievementPercentagesForApp/v2/
| Nazwa | Typ | Wymagane? | Opis |
| gameid | uint64 | ✔ | ID gry, dla której chcesz uzyskać informacje o osiągnięciach. |
Pobiera procenty globalnych osiągnięć dla określonej aplikacji.
Ta metoda ma wcześniejsze wersje, które nie są już oficjalnie obsługiwane. Nadal można ich używać, ale stanowczo zaleca się korzystanie z najnowszej wersji.
Historia zmian:
- Wersja 2 – usunięto nazwy elementów z tablic.
GetGlobalStatsForGame
GET https://partner.steam-api.com/ISteamUserStats/GetGlobalStatsForGame/v1/
| Nazwa | Typ | Wymagane? | Opis |
| appid | uint32 | ✔ | ID aplikacji, dla której mają zostać uzyskane statystyki globalne. |
| count | uint32 | ✔ | Liczba statystyk, dla których mają zostać uzyskane dane. |
| name[0] | string | ✔ | Nazwy statystyk, dla których mają zostać uzyskane dane. |
| startdate | uint32 | | Data rozpoczęcia dziennych łącznych statystyk (w formacie uniksowym). |
| enddate | uint32 | | Data zakończenia dziennych łącznych statystyk (w formacie uniksowym). |
Pobiera procenty globalnych statystyk dla określonej aplikacji.
Przeczytaj
dokumentację statystyk globalnych, by poznać więcej informacji.
GetNumberOfCurrentPlayers
GET https://partner.steam-api.com/ISteamUserStats/GetNumberOfCurrentPlayers/v1/
| Nazwa | Typ | Wymagane? | Opis |
| appid | uint32 | ✔ | ID aplikacji, dla którego ma zostać uzyskana liczba użytkowników. |
Pobiera całkowitą liczbę graczy aktualnie aktywnych w określonej aplikacji na Steam.
Należy pamiętać, że ta opcja nie zwróci graczy, którzy grali bez połączenia ze Steam.
GetPlayerAchievements
GET https://partner.steam-api.com/ISteamUserStats/GetPlayerAchievements/v1/
| Nazwa | Typ | Wymagane? | Opis |
| key | string | ✔ | Klucz autoryzacyjny użytkownika API webowych Steamworks. |
| steamid | uint64 | ✔ | ID Steam użytkownika. |
| appid | uint32 | ✔ | ID aplikacji, dla której mają zostać uzyskane osiągnięcia. |
| l | string | | Język, dla którego mają zostać zwrócone ciągi znaków. |
Pobiera listę osiągnięć odblokowanych w aplikacji przez określonego użytkownika.
GetSchemaForGame
GET https://partner.steam-api.com/ISteamUserStats/GetSchemaForGame/v2/
| Nazwa | Typ | Wymagane? | Opis |
| key | string | ✔ | Klucz autoryzacyjny użytkownika API webowych Steamworks. |
| appid | uint32 | ✔ | ID aplikacji gry. |
| l | string | | Język lokalizacji, jaki ma zostać zwrócony („english” dla angielskiego, „french” dla francuskiego itd.). |
Pobiera całkowitą listę statystyk i osiągnięć dla określonej gry.
Ta metoda ma wcześniejsze wersje, które nie są już oficjalnie obsługiwane. Nadal można ich używać, ale stanowczo zaleca się korzystanie z najnowszej wersji.
Historia zmian:
- Wersja 2 – naprawiono błąd powodujący, że nazwa gry była zwracana w pliku XML.
GetUserStatsForGame
GET https://partner.steam-api.com/ISteamUserStats/GetUserStatsForGame/v2/
| Nazwa | Typ | Wymagane? | Opis |
| key | string | ✔ | Klucz autoryzacyjny użytkownika API webowych Steamworks. |
| steamid | uint64 | ✔ | ID Steam użytkownika. |
| appid | uint32 | ✔ | ID aplikacji gry. |
Pobiera listę statystyk, jakie określony użytkownik pozostawił w danej aplikacji.
Ta metoda ma wcześniejsze wersje, które nie są już oficjalnie obsługiwane. Nadal można ich używać, ale stanowczo zaleca się korzystanie z najnowszej wersji.
Historia zmian:
- Wersja 2 – naprawiono błąd powodujący, że nazwa gry była zwracana w pliku XML.
SetUserStatsForGame
POST https://partner.steam-api.com/ISteamUserStats/SetUserStatsForGame/v1/
| Nazwa | Typ | Wymagane? | Opis |
| key | string | ✔ | Klucz autoryzacyjny wydawcy API webowych Steamworks. |
| steamid | uint64 | ✔ | ID Steam użytkownika. |
| appid | uint32 | ✔ | ID aplikacji gry. |
| count | uint32 | ✔ | Liczba statystyk i osiągnięć, dla których ma zostać przypisana wartość (pary parametrów nazwa/wartość). |
| name[0] | string | ✔ | Nazwa statystyki lub osiągnięcia, jaka ma zostać ustawiona. |
| value[0] | uint32 | ✔ | Wartość, jaka ma zostać ustawiona. |
Ustawia statystyki dla określonego użytkownika w grze.
UWAGA: to wywołanie wymaga, by klucz API wydawcy, który jest właścicielem określonego ID aplikacji, korzystał z tej metody. Z tego powodu to API
MUSI zostać wywołane z zabezpieczonego serwera i nigdy nie może być bezpośrednio używane przez klienty!