Steam
Odznaki
Pobierz odznaki użytkownika Steam, w tym XP, poziom i szczegóły ukończenia.
Endpoint
Ten endpoint zwraca dane o odznakach użytkownika Steam, w tym poziom odznaki, zdobyte XP i timestampy ukończenia. Te dane były wcześniej częścią endpointu summary w v1, a teraz są dostępne jako dedykowany endpoint.
GET /v2/steam/users/{steamid}/badges
Wymagane parametry
steamid
string
Steam ID użytkownika, którego odznaki chcesz pobrać. Akceptuje różne formaty Steam ID.
Uwierzytelnianie
Dołącz swój klucz API jako header x-api-key.
x-api-key: YourSecretAPIKey
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
badges | array | Tablica obiektów odznak |
player_xp | number | Łączne XP zdobyte przez gracza |
player_level | number | Aktualny poziom Steam gracza |
player_xp_needed_to_level_up | number | XP potrzebne do osiągnięcia następnego poziomu |
player_xp_needed_current_level | number | XP wymagane na aktualny poziom |
Obiekt odznaki
| Pole | Typ | Opis |
|---|---|---|
badgeid | number | ID odznaki |
appid | number | ID aplikacji (dla odznak przypisanych do gier, opcjonalne) |
level | number | Aktualny poziom odznaki |
completion_time | number | Unix timestamp zdobycia lub awansu odznaki |
xp | number | XP zdobyte z tej odznaki |
scarcity | number | Liczba użytkowników posiadających tę odznakę |
communityitemid | string | ID itemu społeczności (dla odznak gier, opcjonalne) |
border_color | number | Wartość koloru ramki (dla odznak gier, opcjonalne) |
Przykład odpowiedzi
Przykładowy output dla tego endpointu. Dla zwięzłości niektóre odznaki zostały pominięte.
response.json
{
"success": true,
"response": {
"badges": [
{
"badgeid": 13,
"level": 625,
"completion_time": 1766289028,
"xp": 875,
"scarcity": 916315
},
{
"badgeid": 1,
"appid": 730,
"level": 5,
"completion_time": 1415375204,
"xp": 500,
"communityitemid": "1111254987",
"border_color": 0,
"scarcity": 9204132
}
],
"player_xp": 23450,
"player_level": 42,
"player_xp_needed_to_level_up": 50,
"player_xp_needed_current_level": 400
}
}