Steam
Достижения
Получи достижения Steam-пользователя для конкретной игры, включая статус разблокировки и timestamp.
Эндпоинт
Этот endpoint возвращает список достижений для конкретной игры в аккаунте Steam-пользователя, с текущим статусом разблокировки и timestamp разблокировки для каждого достижения.
GET /v2/steam/users/{steamid}/achievements/{appid}
Обязательные параметры
steamid
string
Steam ID пользователя, чьи достижения ты хочешь получить. Принимает различные форматы Steam ID.
appid
number
Steam application ID игры, достижения которой ты хочешь получить.
Аутентификация
Включи свой API-ключ в request header x-api-key.
x-api-key: YourSecretAPIKey
Поля ответа
| Поле | Тип | Описание |
|---|---|---|
steamID | string | SteamID64 пользователя. |
game | string | Название игры. |
achievements | array | Список объектов достижений для этой игры. См. поля ниже. |
Объект достижения
| Поле | Тип | Описание |
|---|---|---|
name | string | Внутренний идентификатор достижения. |
unlocked | boolean | Разблокировал ли пользователь это достижение. |
unlockedTimestamp | number | Unix timestamp разблокировки достижения. 0, если достижение заблокировано. |
Пример ответа
Пример вывода для этого endpoint'а. Для краткости большинство достижений опущено.
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
}
]
}
}