Una interfaz primaria para interactuar con
Economía de Steam.
Consulta tambien:
ISteamEconomy.
Para obtener más información sobre cómo utilizar la API web de Steamworks, por favor, consulta:
Descripción general de la API web.
GetHistoryCommandDetails
GET https://partner.steam-api.com/IGameInventory/GetHistoryCommandDetails/v1/
Nombre | Tipo | Requerido | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web API de Steamworks. |
appid | uint32 | ✔ | Id. de aplicación del juego. |
steamid | uint64 | ✔ | Id. de Steam de la cuenta en la que se opera. |
command | string | ✔ | El comando para ejecutar en ese activo. |
contextid | uint64 | ✔ | El contexto para buscar la historia. |
arguments | string | ✔ | Argumentos incluidos con el comando la primera vez. |
NOTA: Esta llamada requiere una clave de API de editor para utilizar este método. Como tal, esta API
DEBE ser llamada desde un servidor seguro y ¡nunca puede ser utilizada directamente por tus clientes!
GetUserHistory
GET https://partner.steam-api.com/IGameInventory/GetUserHistory/v1/
Nombre | Tipo | Requerido | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web API de Steamworks. |
appid | uint32 | ✔ | Id. de aplicación del juego. |
steamid | uint64 | ✔ | Id. de Steam para el que se obtiene la historia. |
contextid | uint64 | ✔ | El contexto para buscar la historia. |
starttime | uint32 | ✔ | Hora de inicio del intervalo del historial que se debe reunir. |
endtime | uint32 | ✔ | Hora de fin del intervalo del historial que se debe reunir. |
NOTA: Esta llamada requiere una clave de API de editor para utilizar este método. Como tal, esta API
DEBE ser llamada desde un servidor seguro y ¡nunca puede ser utilizada directamente por tus clientes!
HistoryExecuteCommands
POST https://partner.steam-api.com/IGameInventory/HistoryExecuteCommands/v1/
Nombre | Tipo | Requerido | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web API de Steamworks. |
appid | uint32 | ✔ | Id. de aplicación del juego. |
steamid | uint64 | ✔ | La identificación del activo en el se opera. |
contextid | uint64 | ✔ | El contexto para buscar la historia. |
actorid | uint32 | ✔ | Id. de 32 bits único para el agente de asistencia que ejecuta este comando. |
NOTA: Esta llamada requiere una clave de API de editor para utilizar este método. Como tal, esta API
DEBE ser llamada desde un servidor seguro y ¡nunca puede ser utilizada directamente por tus clientes!
SupportGetAssetHistory
GET https://partner.steam-api.com/IGameInventory/SupportGetAssetHistory/v1/
Nombre | Tipo | Requerido | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web API de Steamworks. |
appid | uint32 | ✔ | Id. de aplicación del juego. |
assetid | uint64 | ✔ | La identificación del activo en el se opera. |
contextid | uint64 | ✔ | El contexto para buscar la historia. |
NOTA: Esta llamada requiere una clave de API de editor para utilizar este método. Como tal, esta API
DEBE ser llamada desde un servidor seguro y ¡nunca puede ser utilizada directamente por tus clientes!
UpdateItemDefs
POST https://partner.steam-api.com/IGameInventory/UpdateItemDefs/v0001
Nombre | Tipo | Requerido | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web API de Steamworks. |
appid | uint32 | ✔ | Id. de aplicación del juego. |
itemdefs | JSON array | ✔ | Una o más definiciones de elementos, presentadas como una matriz JSON, para ser actualizadas o creadas. |
RespuestaLa salida de este método será un objeto JSON.
- respuesta
- success: true si el método fue exitoso. Si el servidor de recursos devuelve "false", debería establecer error0> en una cadena que explique por qué.
- error: una cadena que describe por qué esta llamada falló. Este mensaje se incluirá en el registro de errores, que está disponible en la pestaña Economía del sitio de Steamworks.
- fallo: una matriz de identificación de definición de elemento que esta llamada actualizó correctamente.
Ejemplo de código:curl --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"
Ejemplo de salida{
"result": {
"updated": [
"418",
"403"
],
"failed": [],
"success": true
}
}
Una vez que hayas completado todas las actualizaciones de las definiciones de elementos, si has modificado las marcas comercializables o intercambiables, realiza una llamada a
FlushAssetAppearanceCache para actualizar inmediatamente el estado de los elementos asociados en el mercado. Esta llamada ejecuta una operación costosa del servidor, por lo que solo debe hacerse después de que se completen todas las actualizaciones y solo cuando se hayan modificado estos indicadores.