Steam kutsuu tätä, kun käyttäjä vierailee tukisivustolla ja yrittää etsiä lisätietoja pelinsisäisestä ostosta. Vastaus sisältää tiedon ostettavien esineiden nykytilasta sekä siiitä, onko esine hyvitettävissä.
Kutsuja: Steamin hyvitykset
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 (App ID) sovellukselle, joka liittyy ostoon. Tämä on pelisi sovellustunnus (App ID). |
steamid | uint64 | ✔ | Oston tehneen käyttäjän 64-bittinen Steam ID -tunnus. |
language | string | ✔ | Palautettavien merkkijonojen ISO639-1-kielikoodi ja kaksikirjaiminen ISO 3166-1-maakoodi. Esimerkkejä: en_US, de_DE, zh_CN ja ko_KR. Oletus: en_US. |
orderid | uint64 | ✔ | Tilauksen yksilöllinen 64-bittinen tunnus. Tämä on sama tilaustunnus, joka annettiin ISteamMicroTxn/InitTxn-kutsussa. |
Paluuarvot
Metodin palautuksen tulisi olla koodattu JSON-muodossa.
Vastaus: -
result
-
success
– true (tosi), jos metodi onnistui. Jos elementtipalvelin palauttaa arvon false (epätosi), sen on määritettävä merkkijonoon syyn ilmaiseva error
.
-
error
– merkkijono, joka kertoo syyn kutsun epäonnistumiselle. Viesti tallennetaan virhelokiin, joka on saatavana Steamworks-sivuston Talous-välilehdeltä.
-
assets
– ostettujen lineitems-esineiden taulukko.
-
itemtypeid
– esineen pelitunnus (Game ID). Tämä on sama itemid
-arvo, joka annettiin ISteamMicroTxn/InitTxn-kutsussa.
-
allow_refund
– tämän tulee olla true (tosi), paitsi jos ostettua esinettä on käytetty tai muokattu tai se on siirretty.
-
in_inventory
–true (tosi), jos esineen ostanut käyttäjä omistaa sen edelleen.
-
bundle
– määritä true (tosi), jos käyttäjän ostama esine on myyntipaketti, jossa on useita esineitä. Sisällytä sen jälkeen myyntipaketin esineet seuraaviksi merkinnöiksi assets
-taulukkoon.
-
current_state
– luettavissa oleva merkkijono esineen nykytilasta. Merkkijono näytetään käyttäjälle, ja se tulisi lokalisoida. Mitä tarkempi, sitä parempi, varsinkin kun allow_refund
on false (epätosi). Esimerkiksi: "Käytetty toisen kohteen luomiseen 25.3.2015" tai "Tavaraluettelossasi".
-
item_name
– esineen nimi. Merkkijono näytetään käyttäjälle, ja se tulisi lokalisoida.
-
amount
– ostettujen esineiden määrä. Kaikilla kohteilla on oltava sama id
(ei käytettävissä, jos peli ei tue Steam-talouden ohjelmointirajapintoja). Jos esineitä ostettiin useita, mutta niillä on eri id
-arvot, sisällytä ne assets
-taulukkoon sen sijaan, että käyttäisit tätä kenttää.
HUOM! Seuraavia kenttiä voi käyttää vain, jos peli tukee Steam-talouden ohjelmointirajapintoja.
-
id
– käyttäjälle annetun kohteen elementtitunnus (assetid) tai valuuttatunnus (currencyid).
-
contextid
– esineen sijoituskontekstin tunnus (contextid).
-
currency
– true (tosi), jos id
viittaa valuuttatunnukseen (currencyid).
-
class
– pelin määrittämien elementtiluokkatunnisteiden taulukko. Tämän tulisi olla sama luokka, jonka GetAssetClass/v0001-kutsu palauttaa.
Esimerkki koodista
{
"result": {
"assets": [
{
"itemtypeid": 594,
"contextid": 2,
"currency": false,
"amount": 1,
"id": 3837860447,
"class": [
{
"name": "def_index",
"value": "594"
},
{
"name": "flags",
"value": "16"
},
{
"name": "origin",
"value": "2",
"instance": true
},
{
"name": "@tradable after date",
"value": "1434493482",
"instance": true
}
]
,
"allow_refund": true,
"in_inventory": true,
"bundle": false,
"current_state": "In your inventory",
"item_name": "The Phlogistinator"
},
{
"itemtypeid": 214,
"contextid": 2,
"currency": false,
"amount": 1,
"id": 3837860448,
"class": [
{
"name": "def_index",
"value": "214"
},
{
"name": "flags",
"value": "16"
},
{
"name": "origin",
"value": "2",
"instance": true
},
{
"name": "@tradable after date",
"value": "1434493482",
"instance": true
}
]
,
"allow_refund": true,
"in_inventory": true,
"bundle": false,
"current_state": "In your inventory",
"item_name": "The Powerjack"
}
]
,
"success": true
}
}