Steamworks Belgeleri
GetContextContents/v0001
Bu çağrı, bir kullanıcı için belirli bir bağlam içerisinde bütün varlıkları ve para birimini getirir.

Çağıran: Takas Arayüzü, Envanter Arayüzü

HTTP Yöntemi: GET

Parametreler:

İsimTürGereklilikAçıklama
keystringBu, partner sitesinde uygulamanızın Steam Ekonomi Ayarları kısmında sağlamış olduğunuz "Varlık Sunucusu Anahtarı"dır.
appiduint32Varlıklar ile ilişkilendirilmiş uygulamanın 32-bit App ID'si.
steamiduint64Varlıkların getirileceği kullanıcının 64-bit Steam ID'si.
contextiduint64Varlıkların getirileceği ortamın 64-bit ID'si.

Dönüşler

Bu yöntemin çıktısı JSON biçiminde kodlanmalıdır.

Yanıt:
  • result
    • success - Eğer yöntem başarılı ise True. Eğer varlık sunucusunun yanıtı false ise nedenini anlatan bir dizeye error olarak gelecektir.
    • error - Bu çağrının neden başarısız olduğunu anlatan bir dize. Bu mesaj hata kaydına kaydedilecektir. Hata kaydına Steamworks sitesinde bulunan Ekonomi sekmesinin altından erişebilirsiniz.
    • assets - Belirtilmiş bağlamın çocukları olan varlıkların bir dizisi.
      • id - Varlığın 64-bit ID'si.
      • class - Oyun tarafından belirtilmiş varlık sınıf tanımlayıcılarının bir dizisi. Bu tanımlayıcıların ne olduğu
        oyuna bağlıdır. Sınıf tanımlayıcıları GetAssetClassInfo/v0001'ya gönderildiği zaman,
        varlığı yeniden yaratılması için gerekli bilgiyi (örn. nasıl bir öğe olduğunun açıklaması) vermeleri gerekmektedir. Her tanımlayıcı aşağıdaki alanları içermelidir:
        • name - Sınıf tanımlayıcısının bu bölümünün ismi.
        • value - Sınıf tanımlayıcısının bu bölümünün değeri, bir dize olarak.
        • instance - Eğer bu true ise, sınıf tanımlayıcısı "örnek verisi" " olarak kabul edilir
          Bu durum takastaki bir öğe ile birlikte genellikle hareket etmez ve böylece öğenin takas değerinin etmen olmayacağı anlamına gelir.
          (Varsayılan: False)
          NOT:GetAssetClassInfo/v0001 içerisindeki bir öğenin market_hash_name üzerinde bir varlık sınıf özelliğinin bir etkisi olursa yanıt hiç bir zaman örnek verisi olarak nitelendirilmemelidir. Topluluk Pazarı örnek özelliklerin market_hash_name üzerinde herhangi bir etkisi olmamasına dayanır.
        Steam'in depolayabileceği açıklama bilgisi miktarını maksimize etmek için sınıf tanımlayıcıları olabildiğince çok kullanılabilir ve genel olmalıdır. Örnek olarak, isim olarak "itemid" ve o varlığın 64-bit ID'sinin değer olarak bulunduğu bir özelliğin olduğu bir sınıftan kaçının. Bunun yerine, açıklamayı oluştururken öğenin nasıl bir öğe olduğunu yeterli bilgiyle sunan bir açıklamayı tercih edin. Örnek olarak, "type" = "sword" ve "rarity" = "common" sınıfına sahip bir varlık o öğenin açıklamasını, o öğenin ne olduğunun bilinmesine gerek kalmadan oluşturulmasına olanak sağlar.
      • amount (opsiyonel) - Bu varlık için olan istif miktarı. Kullanıcı bu istiften bu sayıya kadar öğeyi takaslayabilir. (Varsayılan: 1)
    • currency (opsiyonel) - Bu bağlamın içerdiği para birimi türlerinin bir dizisi. Eğer bir kullanıcı belirli bir tür para birimine sahip değilse ve eğer bu oyun içi arayüzde görünür olacak ise burada belirtilmelidir. Para biriminin gösterimi bir varlığınkine çok benzerdir bu yüzden yukarıda varlıklar için belirtilmiş alanlar aynı zamanda para birimi için de uygulanabilir. class ve id alanları hariç. Diğer varlık alanlarına ek olarak, aşağıdaki iki alan para birimi için kullanılmaktadır:
      • id - Bu tür bir para birimine ilişkilendirilmiş, işaretlenmemiş 32-bit ID. Bu ID oyun içerisinde küresel olarak eşsiz olmalıdır.
      • amount - Kullanıcı tarafından sahip olunan bu para birimi türünün miktarını belirten 64-bit tam sayı.

Örnek Çıktı

{ "result": { "assets": [ { "id": 131363189, "class": [ { "name": "def_index", "value": "128" }, { "name": "quality", "value": "3" } ] }, { "id": 131412933, "class": [ { "name": "def_index", "value": "155" }, { "name": "quality", "value": "3" } ] }, { "id": 556669733, "class": [ { "name": "def_index", "value": "583" }, { "name": "flags", "value": "1" }, { "name": "origin", "value": "1", "instance": true } ] }, ] , "success": true } }