Steam
Başarımlar
Bir Steam kullanıcısının belirli bir oyuna ait başarımlarını al; açılış durumu ve timestamp dahil.
Endpoint
Bu endpoint, bir Steam kullanıcısının hesabındaki belirli bir oyun için başarım listesini döndürür; her başarım için mevcut açılış durumu ve açılış timestamp'i ile birlikte.
GET /v2/steam/users/{steamid}/achievements/{appid}
Gerekli parametreler
steamid
string
Başarımlarını getirmek istediğin kullanıcının Steam ID'si. Çeşitli Steam ID formatlarını kabul eder.
appid
number
Başarımlarını getirmek istediğin oyunun Steam application ID'si.
Kimlik Doğrulama
API anahtarını x-api-key request header'ı olarak ekle.
x-api-key: YourSecretAPIKey
Yanıt alanları
| Alan | Tip | Açıklama |
|---|---|---|
steamID | string | Kullanıcının SteamID64'ü. |
game | string | Oyunun adı. |
achievements | array | Bu oyuna ait başarım nesnelerinin listesi. Aşağıdaki alanlara bak. |
Başarım nesnesi
| Alan | Tip | Açıklama |
|---|---|---|
name | string | Başarımın dahili tanımlayıcısı. |
unlocked | boolean | Kullanıcının bu başarımı açıp açmadığı. |
unlockedTimestamp | number | Başarımın açıldığı zamanın Unix timestamp'i. Başarım kilitliyse 0. |
Yanıt örneği
Bu endpoint için örnek çıktı. Kısalık için çoğu başarım atlanmıştır.
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
}
]
}
}