Steamworks-dokumentation
GetAssetPrices/v0001
Returnerer priser og kategorier for genstande, som brugere kan købe. Hvis der er angivet nogen klassefiltre, bør resultaterne være filtreret, hvis nogen af genstandene indeholder mindst én af de angivne nøgler/værdipar. For eksempel hvis der er angivet to filtre, def_index/40 og def_index/50, skal der kun returneres resultater for genstande, hvor def_index-klasseegenskaben er sat til 40 eller 50.

Kaldes af: Webkøb

HTTP-metode: GET

Parametre:

NavnTypePåkrævetBeskrivelse
keystringDette er "nøglen til asset serveren", som du tildelte under din apps indstillinger for Steam-økonomi på partnersiden.
appiduint3232-bit app-ID for applikationen, som er forbundet med aktiverne.
languagestringISO639-1-sprogkode samt ISO 3166-1 alpha 2-landekode for det sprog, resultaterne skal returneres på. Eksempler: en_US, de_DE, zh_CN og ko_KR. Standard: Ingen.
currencystringEn valgfri ISO 4217-valutakode. Hvis en kode er angivet, skal kun priser for denne valuta returneres.
class_countuint32Antallet af angivne klasseidentifikatorer til filtrering.
class_name#stringNavnet på den identifikator, der skal filtreres på. Der vil være en af disse parametre for hvert nummer mellem 0 og class_count-1 (for eksempel class_name0, class_name1, class_name2).
class_value#stringVærdien på den identifikator, der skal filtreres på. Der vil være en af disse parametre for hvert nummer mellem 0 og class_count-1 (for eksempel class_value0, class_value1, class_value2).

Returværdier

Resultatet fra denne metode er kodet i JSON-format.

Svar:
  • result
    • success – true, hvis metoden lykkedes. Hvis asset serveren returnerer false, bør den angive error til en streng, som forklarer hvorfor.
    • error – en streng, som beskriver, hvorfor dette kald mislykkedes. Denne besked vil blive optaget i en fejllog, som er tilgængelig under fanen "Økonomi" på Steamworks-siden.
    • assets – et array af aktiver, som kan købes.
      • name – navnet på aktivet. Dette navn vil blive sendt til StartWebAssetTransaction/v0001.
      • prices – indeholder et underordnet element for hver af de understøttede valutaer, medmindre der blev angivet et valutafilter. I så fald skal der kun inkluderes en pris for den pågældende valuta. Hver underordnede nøgle skal være ISO 4217-valutakoden, og værdien skal være i form af et heltal. Se Understøttede valutaer for at læse mere om, hvordan denne værdi rapporteres.
      • original_prices – hvis genstanden er på udsalg, indeholder denne parameter ikke-udsalgspriserne for genstanden på samme måde som prices. Bør udelades, hvis genstanden ikke er på udsalg.
      • class – et array af spildefinerede aktivklasseidentifikatorer. Se GetContextContents/v0001 for at få flere oplysninger om formatet, som disse klasseidentifikatorer bør have.
      • tags – et array af tags eller kategorier, som gælder for genstanden. Se eksempeloutputtet for at få flere oplysninger. tags-arrayet under result indeholder det lokaliserede navn, som vises for hvert tag.
    • tags – indeholder et underordnet element for hver af de understøttede tags, uden hensyntagen til angivne filtre. Værdierne skal være lokaliseret tekst, hvis sprogparameteren blev angivet, eller et lokaliseringstoken eller en anden identifikator, hvis der ikke blev angivet et sprog.

Eksempeloutput

Outputtet nedenfor er et eksempel for en anmodning med parametre:
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" }, } }