L'interfaccia principale per interagire con
Economia di Steam.
Vedi anche:
ISteamEconomy.
Per ulteriori informazioni sull'API web di Steamworks, consulta la seguente documentazione:
Panoramica sull'API web.
GetHistoryCommandDetails
GET https://partner.steam-api.com/IGameInventory/GetHistoryCommandDetails/v1/
| Nome | Tipo | Necessario | Descrizione |
|---|
| key | string | ✔ | Chiave di autenticazione dell'editore per l'API web di Steamworks. |
| appid | uint32 | ✔ | L'appID del gioco |
| steamid | uint64 | ✔ | L'ID di Steam dell'account su cui operare |
| command | string | ✔ | Il comando da eseguire su quella risorsa |
| contextid | uint64 | ✔ | Il contesto per cui recuperare la cronologia |
| arguments | string | ✔ | Gli argomenti forniti inizialmente insieme al comando |
NOTA: per questo metodo, la chiamata richiede una chiave API da editore. La chiamata API
DEVE arrivare da un server protetto e non può mai essere effettuata dai client!
GetUserHistory
GET https://partner.steam-api.com/IGameInventory/GetUserHistory/v1/
| Nome | Tipo | Necessario | Descrizione |
|---|
| key | string | ✔ | Chiave di autenticazione dell'editore per l'API web di Steamworks. |
| appid | uint32 | ✔ | L'appID del gioco |
| steamid | uint64 | ✔ | L'ID di Steam per cui recuperare la cronologia |
| contextid | uint64 | ✔ | Il contesto per cui recuperare la cronologia |
| starttime | uint32 | ✔ | Orario di inizio dell'intervallo per cui recuperare la cronologia |
| endtime | uint32 | ✔ | Orario di fine dell'intervallo per cui recuperare la cronologia |
NOTA: per questo metodo, la chiamata richiede una chiave API da editore. La chiamata API
DEVE arrivare da un server protetto e non può mai essere effettuata dai client!
HistoryExecuteCommands
POST https://partner.steam-api.com/IGameInventory/HistoryExecuteCommands/v1/
| Nome | Tipo | Necessario | Descrizione |
|---|
| key | string | ✔ | Chiave di autenticazione dell'editore per l'API web di Steamworks. |
| appid | uint32 | ✔ | L'appID del gioco |
| steamid | uint64 | ✔ | L'ID della risorsa su cui operare |
| contextid | uint64 | ✔ | Il contesto per cui recuperare la cronologia |
| actorid | uint32 | ✔ | Un ID unico a 32 bit per l'agente dell'assistenza che esegue il comando |
NOTA: per questo metodo, la chiamata richiede una chiave API da editore. La chiamata API
DEVE arrivare da un server protetto e non può mai essere effettuata dai client!
SupportGetAssetHistory
GET https://partner.steam-api.com/IGameInventory/SupportGetAssetHistory/v1/
| Nome | Tipo | Necessario | Descrizione |
|---|
| key | string | ✔ | Chiave di autenticazione dell'editore per l'API web di Steamworks. |
| appid | uint32 | ✔ | L'appID del gioco |
| assetid | uint64 | ✔ | L'ID della risorsa su cui operare |
| contextid | uint64 | ✔ | Il contesto per cui recuperare la cronologia |
NOTA: per questo metodo, la chiamata richiede una chiave API da editore. La chiamata API
DEVE arrivare da un server protetto e non può mai essere effettuata dai client!
UpdateItemDefs
POST https://partner.steam-api.com/IGameInventory/UpdateItemDefs/v0001
| Nome | Tipo | Necessario | Descrizione |
|---|
| key | string | ✔ | Chiave di autenticazione dell'editore per l'API web di Steamworks. |
| appid | uint32 | ✔ | L'appID del gioco |
| itemdefs | matrice JSON | ✔ | Una o più definizioni di oggetti, presentate in una matrice JSON, da aggiornare o creare. |
RispostaL'output di questo metodo sarà un oggetto JSON.
- risposta
- success: se il metodo è riuscito, restituisce "true". Se il server della risorsa restituisce "false", imposta la stringa error che ne fornisce una spiegazione.
- error: una stringa che descrive il motivo per cui la chiamata è fallita. Questo messaggio verrà incluso nel registro degli errori, disponibile sulla scheda Economia del sito di Steamworks.
- failed - una matrice di ID di definizione di un oggetto aggiornate con successo da questa chiamata.
Esempio di codicecurl --request POST \
--header "Content-Type: application/x-www-form-urlencoded" \
--form appid=30400 \
--form 'itemdefs=[{"appid":"30400","itemdefid":"418","type":"item","display_type":"bag","name":"Bag of Stuff","description":"This bag contains stuff.","background_color":"993300","tradable": true,"marketable": true,"commodity": true,"tags":"class:human;type:bag"}, {"appid": "30400","itemdefid":"403","type":"item","display_type":"cat","name":"Cat of Bags","description":"This cat contains multitudes."}]'
"https://api.steampowered.com/IGameInventory/UpdateItemDefs/v0001?key=xxxxxx"
Esempio di output{
"result": {
"updated": [
"418",
"403"
],
"failed": [],
"success": true
}
}
Una volta che avrai completato tutti gli aggiornamenti alle definizioni degli oggetti, se hai contrassegnato in maniera diversa la possibilità di vendere o scambiare effettua una chiamata a
FlushAssetAppearanceCache per aggiornare immediatamente lo stato dei relativi oggetti sul mercato. Questa chiamata esegue un'operazione dai requisiti elevati sul server, per cui dovrebbe essere effettuata solo al termine di tutti gli aggiornamenti e una volta che i contrassegni sono stati modificati.