Questa funzione viene chiamata da Steam quando un utente sta visitando il sito dell'assistenza e sta cercando di ottenere ulteriori informazioni su un acquisto in gioco. La risposta comprende l'attuale stato degli oggetti coinvolti in un acquisto e l'informazione sull'effettiva possibilità di rimborso per ciascun oggetto.
Chiamata da: Rimborsi di Steam
Metodo HTTP: GET
Parametri:
Nome | Tipo | Necessario | Descrizione |
key | stringa | ✔ | Questo è il "codice del server delle risorse" che hai fornito nelle impostazioni Economia di Steam sul sito per i partner della tua applicazione. |
appid | uint32 | ✔ | L'appID a 32 bit dell'applicazione associata all'acquisto. Sarà l'appID del tuo gioco. |
steamid | uint64 | ✔ | Lo SteamID a 64 bit dell'utente che ha effettuato l'acquisto. |
language | stringa | ✔ | Il codice lingua ISO639-1 più il codice nazionale ISO 3166-1 alpha-2 della lingua in cui restituire le stringhe. Alcuni esempi includono en_US, de_DE, zh_CN e ko_KR. Impostazione predefinita: en_US. |
orderid | uint64 | ✔ | L'ID univoco a 64 bit dell'ordine. È lo stesso ID dell'ordine restituito nella chiamata ISteamMicroTxn/InitTxn. |
Restituzioni
L'output di questo metodo deve essere codificato nel formato JSON.
Risposta: -
result
-
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 alla scheda Economia del sito di Steamworks.
-
assets:
una matrice di oggetti acquistati.
-
itemtypeid
: numero di ID dell'oggetto del gioco. Si tratta del valore itemid
restituito dalla chiamata ISteamMicroTxn/InitTxn.
-
allow_refund
: deve essere impostato su "true" a meno che l'elemento non sia stato utilizzato, modificato o trasferito.
-
in_inventory
: restituisce "true" se l'utente che sta acquistando possiede ancora l'oggetto.
-
bundle
: se l'oggetto acquistato dall'utente è in realtà un bundle contenente più oggetti, imposta questo parametro su "true" e includi quindi gli oggetti contenuti nel bundle come voci successive nella matrice delle risorse assets
.
-
current_state
: una stringa leggibile dall'utente sullo stato attuale dell'oggetto. Questa stringa viene visualizzata dall'utente e deve essere possibilmente tradotta. La stringa deve essere più specifica possibile, specialmente quando allow_refund
restituisce "false". Potrebbe riportare, ad esempio, "Utilizzato per creare un altro oggetto il 25 marzo 2015" o "Parte del tuo inventario".
-
item_name
: il nome dell'oggetto. Questa stringa viene visualizzata dall'utente e deve essere possibilmente tradotta.
-
amount
: le unità acquistate per l'oggetto. Tutti gli oggetti devono avere lo stesso id
(non applicabile se il gioco non supporta le API dell'Economia di Steam). Se sono stati acquistati più oggetti che presentano id
diversi, includi più elementi nella matrice assets
invece di utilizzare questo campo.
NOTA: i campi che seguono sono da applicare solo se il gioco supporta le nostre API dell'Economia di Steam.
-
id
: l'ID della risorsa o l'ID della valuta dell'oggetto che è stato assegnato all'utente.
-
contextid
: l'ID del contesto in cui è stato posizionato l'oggetto.
-
currency
: restituisce "true" se id
si riferisce a un ID valuta.
-
class
: una matrice di identificatori di classe della risorsa definiti dal gioco. La classe deve essere la stessa restituita da GetAssetClass/v0001.
Esempio di output
{
"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
}
}