Käyttäjälle palautetaan kaikki elementit ja valuutta tietyssä kontekstissa.
Kutsuja: Vaihtojen käyttöliittymä, tavaraluettelokäyttöliittymä
HTTP-metodi: GET
Parametrit:
| Nimi | Tyyppi | Pakollinen | Kuvaus |
|---|
| key | string | ✔ | Tämä on elementtipalvelimen tunnus, jonka annoit sovelluksesi kumppanisivulla Steam-talouden asetuksissa. |
| appid | uint32 | ✔ | 32-bittinen sovellustunnus (AppID) sovellukselle, joka liittyy elementteihin. |
| steamid | uint64 | ✔ | Käyttäjän 64-bittinen SteamID-tunnus, jolla elementit palautetaan. |
| contextid | uint64 | ✔ | Kontekstin 64-bittinen tunnus elementtien palauttamiseksi. |
Paluuarvot:
Metodin palautuksen tulisi olla koodattu JSON-muodossa.
Vastaus: -
result
-
success – True (tosi), jos metodi onnistui. Jos elementtipalvelin palauttaa false (epätosi), tulisi se määrittää error merkkijonoon, joka selittää sen syyn.
-
error – Merkkijono, joka kertoo, miksi kutsu epäonnistui. Viesti tallennetaan virhelokiin, joka on saatavana Steamworks-sivuston Talous-välilehdeltä.
-
assets – Taulukko elementtejä, jotka ovat tietyn kontekstin alikohteita.
-
id – 64-bittinen elementin tunnus.
-
class – Pelin määrittämien elementtiluokan tunnisteiden taulukko. Peli määrittelee, mitä nämä tunnisteet ovat
.
Niissä tulee olla riittävästi tietoja elementistä,
(esim. esineen kuvaus), kun luokkatunnisteet lähetetään takaisin GetAssetClassInfo/v0001-metodiin. Jokaisessa tunnisteessa tulee olla seuraavat kentät:
-
name – Tämän luokkatunnisteen osan nimi.
-
value – Tämän luokkatunnisteosan arvo merkkijonona.
-
instance – Jos tämä on true (tosi), luokkatunniste käsitetään "esiintymätietoksi" eikä se
yleensä siirry vaihdettavan esineen mukana. Näin se ei vaikuta esineen vaihtoarvoon.
(Oletus: false (epätosi))
Huomaa! Elementtiluokan ominaisuus, joka vaikuttaa esineen market_hash_name-nimeen GetAssetClassInfo/v0001-metodissa, ei tulisi koskaan käsittää esiintymätietoina. Yhteisön kauppapaikka edellyttää, että esiintymän ominaisuudet eivät vaikuta market_hash_name-nimeen.
Jotta voidaan maksimoida kuvaustietojen määrä, jotka Steam pystyy tallentamaan välimuistiin, luokan tunnisteiden pitäisi olla mahdollisimman yleisiä ja uudelleenkäytettäviä. Vältä esimerkiksi sellaisia luokkia, joissa on vain yksi ominaisuus, jolla on "itemid"-tyyppinen nimi, ja arvo, joka on elementin 64-bittinen tunnus. Kuvaile esinettä sen sijaan tarpeeksi rikkaalla tavalla, jotta saat tehtyä määrityksen. Esimerkiksi elementtiluokat "type = sword" ja "rarity = common" antavat riittävästi tietoja, jotta voit rakentaa esineen kuvauksen, vaikka et tietäisi tarkkaan, mistä esineen esiintymästä on kyse.
-
amount (valinnainen) – Elementin pinomäärä. Käyttäjä voi vaihtaa pinosta enintään tämän määrän yksiköitä. (Oletus: 1)
-
currency (valinnainen) – Tämän kontekstin valuuttatyyppitaulukko. Jos käyttäjällä ei ole tiettyä valuuttaa, se pitäisi sisällyttää tähän vain, jos se on näkyvissä pelin käyttöliittymässä. Valuutan näkymä muistuttaa elementin esitystä, joten edellä mainitut kentät koskevat myös valuuttaa paitsi class ja id. Muiden elementtikenttien lisäksi valuutta käyttää seuraavaa kahta kenttää:
-
id – Etumerkitön 32-bittinen tunnus, joka on määritetty tällä valuuttatyypille. Tunnuksen on oltava pelissä globaalisti yksilöllinen.
-
amount – 64-bittinen kokonaisluku, joka ilmaisee sen, kuinka paljon käyttäjällä on tätä valuuttaa.
Esimerkki koodista
{
"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
}
}
