Questa funzione restituisce i prezzi e le categorie degli oggetti che gli utenti possono acquistare. Se sono specificati eventuali filtri di classe, è necessario applicare filtri ai risultati nel caso in cui uno degli oggetti restituiti contenga almeno una delle coppie chiave/valore specificate. Ad esempio, se sono specificati i filtri
def_index/40
e
def_index/50
, devono essere restituiti solo i risultati per gli oggetti con proprietà della classe def_index impostata su 40 o 50.
Chiamata da: Acquisto web
Metodo HTTP: GET
Parametri:
Nome | Tipo | Necessario | Descrizione |
key | string | ✔ | Questo è il "codice del server delle risorse" che hai fornito nelle impostazioni Economia di Steam sul sito per i partner. |
appid | uint32 | ✔ | L'appID a 32 bit dell'applicazione associata alle risorse. |
language | string | ✔ | Il codice lingua ISO639-1 più il codice nazionale ISO 3166-1 alpha-2 della lingua in cui restituire i risultati. Alcuni esempi includono en_US, de_DE, zh_CN e ko_KR. Impostazione predefinita: nessuno |
currency | string | ✔ | Un codice valuta ISO 4217 opzionale. Se specificato, è necessario restituire solo i prezzi per questa valuta. |
class_count | uint32 | ✔ | Il numero di identificatori di classe specificati per applicare filtri. |
class_name# | string | ✔ | Il nome dell'identificatore a cui applicare filtri. Sarà presente uno di questi parametri per ciascun valore compreso tra 0 e class_count-1 (es. class_name0, class_name1, class_name2 ecc.). |
class_value# | string | ✔ | Il valore dell'identificatore a cui applicare filtri. Sarà presente uno di questi parametri per ciascun valore compreso tra 0 e class_count-1 (ad esempio class_value0, class_value1, class_value2). |
Restituisce
L'output di questo metodo deve essere codificato nel formato JSON.
Risposta: -
result
-
success
: se il metodo è riuscito, restituisce "true". Se il server della risorsa restituisce "false", imposta la stringa error
che ne fornisce una spiegazione.
-
error
: una stringa che descrive il motivo per cui la chiamata è fallita. Questo messaggio verrà incluso nel registro degli errori, disponibile alla scheda Economia del sito di Steamworks.
-
assets:
una matrice di risorse che possono essere acquistate.
-
name
: il nome della risorsa. Questo è il nome che sarà passato a StartWebAssetTransaction/v0001.
-
prices
: include un elemento figlio per ciascuna delle valute supportate a meno che non sia stato specificato un filtro di valuta, nel qual caso è necessario includere il prezzo solo per tale valuta. Ogni chiave figlio deve essere rappresentata dal codice valuta ISO 4217 e riportare come valore un valore intero non firmato. Per ulteriori informazioni su come riportare questo valore, consulta la sezione Valute supportate.
-
original_prices
: se questo oggetto è in vendita, il parametro include i prezzi non destinati alla vendita dell'oggetto nello stesso modo di prices
. Se l'oggetto non è in vendita, questo parametro deve essere omesso.
-
class
: una matrice di identificatori di classe della risorsa definiti dal gioco. Per i dettagli sul formato necessario per tali identificatori di classe, consulta GetContextContents/v0001.
-
tags
: una matrice di etichette o categorie che si applicano all'oggetto. Per ulteriori informazioni, dai un'occhiata all'output di esempio. La matrice tags
sotto result
include il nome tradotto da visualizzare per ogni etichetta.
-
tags
: include un elemento figlio per ciascuna delle etichette supportate, indipendentemente dai filtri specificati. Se il parametro lingua è stato specificato, i valori devono essere testo tradotto. In caso contrario, i valori devono essere un token di traduzione o un identificatore di altro tipo.
Esempio di output
L'output riportato qui sotto è un esempio per una richiesta avente i parametri:
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"
},
}
}