Steam
Envanter
Belirli bir uygulama ve context için bir Steam kullanıcısının envanterini getir; varlıkları, her varlığın görsel ve market metadata'sını çözen description'larla birlikte döndürür.
Endpoint
Bu endpoint, belirli bir uygulama ve context için bir kullanıcının Steam envanterini döndürür. Yanıt, Steam'in kendi envanter yapısını birebir yansıtır: sahip olunan item'ları listeleyen bir assets array'i ve her varlığın görsel ve market metadata'sını classid + instanceid üzerinden çözen bir descriptions array'i.
GET /v2/steam/users/{steamid}/inventory/{appId}/{contextId}
Gerekli parametreler
steamid
string
Envanterini getirmek istediğin kullanıcının Steam ID'si. Çeşitli Steam ID formatlarını kabul eder.
appId
number
Envanterini getirmek istediğin oyunun Steam uygulama ID'si (örneğin Counter-Strike 2 için
730).contextId
number
Uygulamanın envanteri içindeki context ID. Çoğu oyun için context ID
2'dir.Kimlik Doğrulama
API anahtarını x-api-key request header'ı olarak ekle.
x-api-key: YourSecretAPIKey
Yanıt alanları
| Alan | Tip | Açıklama |
|---|---|---|
assets | array | Kullanıcının sahip olduğu item'lar. Her varlık, classid + instanceid üzerinden bir description'a referans verir. |
descriptions | array | assets tarafından referans verilen her benzersiz item class/instance'ını tanımlayan metadata. Birden fazla varlık genellikle tek bir description'ı paylaşır. |
Asset nesnesi
| Alan | Tip | Açıklama |
|---|---|---|
appid | number | Varlığın ait olduğu uygulama ID'si. |
contextid | string | Varlığın bulunduğu context ID. |
assetid | string | Kullanıcının envanterindeki bu belirli varlığın benzersiz ID'si. |
classid | string | Varlığın description'ını aramak için kullanılan class ID. |
instanceid | string | Varlığın description'ını aramak için (classid ile birlikte) kullanılan instance ID. |
amount | string | Bu varlığın miktarı. İstiflenebilir item'lar dışında neredeyse her zaman "1". |
Description nesnesi
| Alan | Tip | Açıklama |
|---|---|---|
appid | number | Uygulama ID'si. |
classid | string | Class ID — assets[].classid ile eşleşir. |
instanceid | string | Instance ID — assets[].instanceid ile eşleşir. |
currency | number | Item bir oyun içi para birimiyse 1, aksi halde 0. |
background_color | string | Steam'in UI'ında item ikonunun arkasında kullanılan hex renk. |
icon_url | string | Steam'in CDN'indeki item ikonunun göreli yolu. |
icon_url_large | string | Steam'in CDN'indeki büyük item ikonunun göreli yolu (her zaman mevcut değildir). |
descriptions | array | Zengin metin açıklama satırları (silah açıklaması, sandık içerikleri, özellikler vb.). |
tradable | number | Item takas edilebiliyorsa 1, aksi halde 0. |
marketable | number | Item Steam Community Market'te satılabiliyorsa 1, aksi halde 0. |
commodity | number | Item bir emtia (değiştirilebilir) ise 1, aksi halde 0. |
market_tradable_restriction | number | Item'ın takas edilebilir hale gelmesine kalan gün sayısı. |
market_marketable_restriction | number | Item'ın satılabilir hale gelmesine kalan gün sayısı. |
name | string | Item görüntü adı. |
name_color | string | Steam'in UI'ında item adı için kullanılan hex renk (nadirliği yansıtır). |
type | string | Item tür sınıflandırması (örneğin "Base Grade Container", "Mil-Spec Grade SMG"). |
market_name | string | Market görüntü adı. |
market_hash_name | string | Market endpoint'lerini sorgulamak için kullanılan URL-güvenli market adı. |
actions | array | Inspect linkleri gibi oyun içi aksiyonlar. Her zaman mevcut değildir. |
market_actions | array | Market sayfasından inspect linkleri gibi market kapsamlı aksiyonlar. Her zaman mevcut değildir. |
tags | array | Sınıflandırma etiketleri (tür, silah, nadirlik, dış görünüm, koleksiyon vb.). |
sealed | number | Sandık mühürlüyse 1, aksi halde 0. |
sealed_type | number | İç mühürlü sandık türü. |
market_bucket_group_name | string | Market bucket gruplama adı (Steam tarafından varyantları gruplamak için kullanılır). |
market_bucket_group_id | string | Market bucket gruplama ID'si. |
Icon URL'leri görelidir. Bunları render etmek için Steam CDN base'ini öne ekle:
https://community.cloudflare.steamstatic.com/economy/image/{icon_url}
Yanıt örneği
Kısalık için assets ve descriptions array'leri kısaltılmıştır — gerçek bir yanıt, envanterdeki her item için bir asset ve her benzersiz classid + instanceid çifti için bir description içerir.
response.json
{
"success": true,
"result": {
"assets": [
{
"appid": 730,
"contextid": "2",
"assetid": "50813022021",
"classid": "5710094579",
"instanceid": "8336926543",
"amount": "1"
}
],
"descriptions": [
{
"appid": 730,
"classid": "5710094579",
"instanceid": "8336926543",
"currency": 0,
"background_color": "393b3e",
"icon_url": "i0CoZ81Ui0m-9KwlBY1L_18myuGuq1wfhWSaZgMttyVfPaERSR0Wqmu7LAocGJKz2lu_XsnXwtmkJjSU91dh8bj35VTqVBP4io_frnEVvqf_a6VoIfGSXz7Hlbwg57QwSS_mxhl15jiGyN37c3_GZw91W8BwRflK7EfKsa2sfw",
"tradable": 1,
"name": "Kilowatt Case",
"name_color": "b0c3d9",
"type": "Base Grade Container",
"market_name": "Kilowatt Case",
"market_hash_name": "Kilowatt Case",
"commodity": 1,
"market_tradable_restriction": 7,
"market_marketable_restriction": 7,
"marketable": 1,
"tags": [
{ "category": "Type", "internal_name": "CSGO_Type_WeaponCase", "localized_category_name": "Type", "localized_tag_name": "Container" },
{ "category": "Rarity", "internal_name": "Rarity_Common", "localized_category_name": "Quality", "localized_tag_name": "Base Grade", "color": "b0c3d9" }
],
"sealed": 0,
"sealed_type": 0,
"market_bucket_group_name": "Kilowatt Case",
"market_bucket_group_id": "G18A8263004"
}
]
}
}