Steamworks-dokumentaatio
GetHistoryCommandDetails/v0001
Tämä palauttaa kaikki käyttäjän seurantatietueet määritetyllä aikajaksolla. Palautettava aikajakso on mikä tahansa tapahtuma aloitusajankohdan starttime jälkeen mutta ennen päättymisaikaa endtime tai sen aikaan.

Kutsuja: Tukityökalu

HTTP-metodi: GET
Palauttaa listan yksityiskohtaisia toimintoja, jotka elementtipalvelin suorittaa, jos tämä komento on vahvistettu. Kun kyse on monimutkaisista toiminnoista, asiakastuen henkilö voi valinnaisesti ottaa käyttöön tai poistaa käytöstä osia maksutapakomennoista. Jos asiaskastuen henkilö vahvistaa yksityiskohdat, kutsutaan HistoryExecuteCommand/v0001-komentoa.

Parametrit:

NimiTyyppiPakollinenKuvaus
keystringTämä on elementtipalvelimen tunnus, jonka annoit sovelluksesi kumppanisivulla Steam-talouden asetuksissa.
appiduint3232-bittinen sovellustunnus (AppID) sovellukselle, joka liittyy elementteihin.
steamiduint64Käyttäjän 64-bittinen SteamID-tunnus, jolla elementit palautetaan.
contextiduint64Elementtien sisältävän kontekstin 64-bittinen tunnus.
commandstringHistoriakomennon nimi.
argumentsuint32Argumenttimerkkijono, jonka GetUserHistory palautti tälle komennolle.

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 syyn kutsun epäonnistumiselle. Viesti tallennetaan virhelokiin, joka on saatavilla Steamworks-sivuston Talous-välilehdellä.
    • actions – Taulukko toimintoja, jotka elementtipalvelin suorittaa, jos asiakastuki vahvistaa komennon.
      • name – Elementin tunnus, johon toiminto vaikuttaa.
      • icon_url (valinnainen) – Elementin kuvake. Kuvan muoto on JPEG, GIF tai PNG ja koko vähintään 96 x 96 pikseliä. PNG- ja GIF-tiedostomuotoja suositellaan, koska ne tukevat läpinäkyvyyttä.
      • name – Elementin nimi, johon toiminto vaikuttaa.
      • command – Alikomento, joka suoritetaan elementissä. Arvo lähetetään takaisin vahvistusvaiheessa.
      • note (valinnainen) – Lisätiedot, jotka näytetään nimen alla vahvistusikkunassa.
      • argument (valinnainen) – Argumenttimerkkijono, joka lähetetään takaisin, jos toiminto on edelleen valittuna vahvistusvaiheessa.
      • steamid(valinnainen) – Elementin tällä hetkellä omistavan käyttäjän 64-bittinen SteamID-tunnus. Käyttäjän nimi näytetään elementin nimen vieressä.
      • optional(valinnainen) – Jos tämä on true (tosi), tuen henkilö voi poistaa toiminnon ja ohittaa sen komennossa. Oletuksena on true (tosi).
      • default (valinnainen) – Valintaruudun oletusasetus vahvistusikkunassa. Oletuksena on true (tosi).

Esimerkki koodista

{ "result":1, "actions": [ { "id":"2111437", "icon_url":"http://media.steampowered.com/apps/440/icons/berliners_bucket_helm.2c1288625a8ab4c16e3c804a6649254b1a9325ca.png", "name":"Berliner's Bucket Helm", "command":"Restore", "note":"Purchased" }, { "id":"2121062", "icon_url":"http://media.steampowered.com/apps/440/icons/gift_fashion.37487e85b245787048aacefe67105bbe44a20e0c.png", "name":"Manniversary Package", "command":"Delete", "note":"Timed Drop" }, ], "displaytext":"" }