Gibt Preise und Kategorien von Gegenständen zurück, die Nutzer kaufen können. Wenn Klassenfilter angegeben sind, sollten die Ergebnisse nach zurückgegebenen Gegenständen gefiltert werden, die mindestens eines der angegebenen Schlüssel-Wert-Paare enthalten. Wenn beispielsweise zwei Filter,
def_index/40 und
def_index/50 angegeben sind, sollten nur Ergebnisse für Gegenstände zurückgegeben werden, in denen die def_index Klasseneigenschaft auf 40 oder 50 gesetzt ist.
Aufgerufen von: Webeinkäufe
HTTP-Methode: GET
Parameter:
| Name | Typ | Erforderlich? | Beschreibung |
|---|
| key | string | ✔ | Dies ist der „Asset-Server-Schlüssel“, den Sie in den Steam-Wirtschaftseinstellungen Ihrer Anwendung auf der Partnerseite angegeben haben. |
| appid | uint32 | ✔ | Die 32-Bit-App-ID der Anwendung, auf die sich das Element bezieht. |
| language | string | ✔ | Der Sprachcode (ISO 639-1) sowie der Ländercode (ISO 3166-1 alpha 2) der Sprache des zurückgegebenen Ergebnisses. Beispiele: en_US, de_DE, zh_CN oder ko_KR. Standardeinstellung: Keine. |
| currency | string | ✔ | Optionaler Währungscode gemäß ISO 4217. Wenn angegeben, müssen nur Preise in dieser Währung zurückgegeben werden. |
| class_count | uint32 | ✔ | Die Anzahl der Klassenbezeichner, die für den Filter festgelegt sind. |
| class_name# | string | ✔ | Der Name des Bezeichners, nach dem gefiltert werden soll. Es gibt einen dieser Parameter für jede Zahl zwischen 0 und class_count-1 (z. B. class_name0, class_name1, class_name2). |
| class_value# | string | ✔ | Der Wert des Bezeichners, nach dem gefiltert werden soll. Es gibt einen dieser Parameter für jede Zahl zwischen 0 und class_count-1 (z. B. class_value0, class_value1, class_value2). |
Rückgabewert
Die Ausgabe dieser Methode sollte im JSON-Format kodiert sein.
Antwort: -
result
-
success – "true", wenn die Methode erfolgreich war. Wenn der Asset-Server "false" zurückgibt, sollte error auf einen String eingestellt werden, in dem der Grund dafür erklärt wird.
-
error – Ein String, der beschreibt, warum dieser Aufruf fehlgeschlagen ist. Diese Nachricht wird im Fehlerprotokoll aufgezeichnet, das im Tab „Wirtschaft‟ der Steamworks-Website verfügbar ist.
-
assets – Ein Array von Elementen, die gekauft werden können.
-
name – Der Name des Elements. Dieser wird an StartWebAssetTransaction/v0001 übergeben.
-
prices – Enthält ein untergeordnetes Element für jede der unterstützten Währungen, es sei denn, es wurde ein Währungsfilter festgelegt. In diesem Fall sollte nur ein Preis für diese Währung angegeben werden. Die untergeordneten Schlüssel müssen im Währungsformat ISO 4217 vorliegen, und der Wert muss als Integer ohne Vorzeichen gemeldet werden. Weitere Informationen zum Melden dieses Werts finden Sie unter Unterstützte Währungen.
-
original_prices: Wenn dieser Gegenstand zum Verkauf steht, enthält dies den Nichtverkaufspreis des Gegenstands genau wie bei prices. Dies sollte nicht angegeben werden, wenn der Gegenstand nicht zum Verkauf steht.
-
name: ein Array von im Spiel definierten Elementklassenbezeichnern. Informationen dazu, welche Formate diese Klassenbezeichner aufweisen können finden, finden Sie unter GetContextContents/v0001.
-
tags: Ein Array von Tags oder Kategorien, die sich auf das Element beziehen. Weitere Informationen finden Sie in der Beispielausgabe. tags innerhalb von result enthält den lokalisierten Anzeigenamen für jeden Tag.
-
tags: Enthält ein untergeordnetes Element für jedes der unterstützten Tags, unabhängig von eventuell angegebenen Filtern. Wenn der Sprachparameter eingestellt wurde, sollten die Werte lokalisierten Text umfassen; wenn nicht, sollten sie ein Lokalisierungs-Token oder einen anderen Bezeichner liefern.
Beispielausgabe
Die folgende Ausgabe ist ein Beispiel für eine Anfrage mit Parametern:
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"
},
}
}
