Steamworks-dokumentaatio
QueryRefundAllowed/v0001
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:

NimiTyyppiPakollinenKuvaus
keystringTämä on elementtipalvelimen tunnus, jonka annoit sovelluksesi kumppanisivulla Steam-talouden asetuksissa.
appiduint3232-bittinen sovellustunnus (App ID) sovellukselle, joka liittyy ostoon. Tämä on pelisi sovellustunnus (App ID).
steamiduint64Oston tehneen käyttäjän 64-bittinen Steam ID -tunnus.
languagestringPalautettavien merkkijonojen ISO639-1-kielikoodi ja kaksikirjaiminen ISO 3166-1-maakoodi.
Esimerkkejä: en_US, de_DE, zh_CN ja ko_KR. Oletus: en_US.
orderiduint64Tilauksen 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 } }