Bu çağrı, kullanıcılara satın alabilecekleri öğelerin kategorilerini ve ücretlerini getirir. Eğer sınıf filtreleri belirtilmiş ise sonuçlar, getirilen öğeler belirtilmiş anahtar/değer eşleşmelerinden en az birini içererek getirilecek şekilde filtrelenecektir. Örneğin, eğer
def_index/40 ve
def_index/50 filtreleri belirtilmiş ise sadece def_index sınıf özellikleri 40 veya 50 olarak ayarlanmış öğeler getirilecektir.
Çağıran: Web Satın Alma
HTTP Yöntemi: GET
Parametreler:
| İsim | Tür | Gereklilik | Açıklama |
|---|
| key | string | ✔ | Bu, partner sitesinde uygulamanızın Steam Ekonomi Ayarları kısmında sağlamış olduğunuz "Varlık Sunucusu Anahtarı"dır. |
| appid | uint32 | ✔ | Varlıklar ile ilişkilendirilmiş uygulamanın 32-bit App ID'si. |
| language | string | ✔ | ISO639-1 dil koduna ek olarak sonuçların getirileceği ISO 3166-1 alpha 2 ülke kodu. Bazı örnekleri en_US, de_DE, zh_CN ve ko_KR sayılabilir. Varsayılan: Hiçbiri |
| currency | dize | ✔ | Opsiyonel bir ISO 4217 para birimi kodu. Eğer belirtilmiş ise sadece bu para birimi için olan ücretleri döndürür. |
| class_count | uint32 | ✔ | Filtreleme için belirtilmiş sınıf tanımlayıcılarının sayısı. |
| class_name# | string | ✔ | Filtrelenecek tanımlayıcının ismi. 0 ile class_count-1 arasındaki her numara için bu parametrelerden bir tane olacaktır. (ör. class_name0, class_name1, class_name2) |
| class_value# | string | ✔ | Filtrelenecek tanımlayıcının değeri. 0 ile class_count-1 arasındaki her numara için bu parametrelerden bir tane olacaktır. (örn. class_value0, class_value1, class_value2) |
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 - satın alınabilecek varlıkların dizisi.
-
id - Varlığın adı. Bu, StartWebAssetTransaction/v0001 tarafına gönderilecek olan isim olacaktır.
-
prices - Eğer bir para birimi filtresi belirtilmemiş ise ki bu durumda sadece o para birimindeki ücreti içerir, desteklenen her para birimi için bir çocuk elementi içerir. Eğer çocuk anahtarı ISO 4217 para birimi kodunda olmalıdır ve değerleri işaretlenmemiş bir tam sayı olarak bildirilmelidir. Bu değerin nasıl bildirileceği konusunda daha fazla bilgi için: Desteklenen Para Birimleri
-
original_prices - Eğer bu öpe indirimde ise, bu yanıt prices ile aynı tarzda öğenin indirim öncesi fiyatını içerir. Eğer öğe indirimde değilse bu yanıt göz ardı edilmelidir.
-
class - Oyun tarafından belirtilmiş varlık sınıf tanımlayıcılarının bir dizisi. Bu sınıf tanımlayıcılarının alması gerektiği format hakkında detaylar için: GetContextContents/v0001
-
tags - Öğeye uygulanan kategorilerin veya etiketlerin bir dizisi. Daha fazla bilgi için örnek çıktıyı inceleyin. result yanıtı altındaki tags dizisi her etiket için yerelleştirilmiş isimleri gösterir.
-
tags - Belirtilmiş herhangi bir filtreye rağmen, desteklenen her bir etiket için bir çocuk elementi içerir. Bu değerler, eğer dil parametresi veya bir yerelleştirme belirteci veya herhangi bir dil belirtilmemiş ise başka bir tanımlayıcı belirtilmiş ise yerelleştirilmiş metin olmalıdır.
Örnek Çıktı
Aşağıdaki çıktı parametreli bir isteğin örneğidir:
language=english&class_count=3&class_name0=def_index&class_value0=5021&class_name1=def_index&class_value1=58&class_name2=def_index&class_value2=647{
"result": {
"success": true
"assets": [
{
"name": "5021",
"prices": {
"USD": 249,
"GBP": 199,
"EUR": 199,
"RUB": 7400
},
"class": [
{
"name": "def_index",
"value": "5021"
}
]
,
"tags": [
"Tools"
]
},
{
"name": "58",
"prices": {
"USD": 74,
"GBP": 44,
"EUR": 55,
"RUB": 2250
},
"original_prices": {
"USD": 99,
"GBP": 59,
"EUR": 74,
"RUB": 3000
},
"class": [
{
"name": "def_index",
"value": "58"
}
]
,
"tags": [
"Weapons"
]
},
{
"name": "647",
"prices": {
"USD": 749,
"GBP": 499,
"EUR": 549,
"RUB": 22400
},
"class": [
{
"name": "def_index",
"value": "647"
}
]
,
"tags": [
"New",
"Misc"
]
}
]
,
"tags": {
"Headgear": "Hats",
"Misc": "Misc",
"Weapons": "Weapons",
"Tools": "Tools",
"Collections": "Collections",
"Bundles": "Bundles",
"Maps": "Maps",
"New": "New Releases"
},
}
}
