Documentación de Steamworks
Interfaz IGameInventory
La interfaz primaria para interactuar con Economía de Steam.
Consulta tambien: ISteamEconomy.

Para obtener más información sobre cómo utilizar la Web de API de Steamworks, consulta el artículo Descripción general de la Web de API.

GetHistoryCommandDetails

GET https://partner.steam-api.com/IGameInventory/GetHistoryCommandDetails/v1/
NombreTipoObligatorioDescripción
keystringClave de autenticación de editor de la Web de API de Steamworks.
appiduint32Id. de aplicación del juego.
steamiduint64Id. de Steam de la cuenta en la que se opera.
commandstringEl comando para ejecutar en ese activo.
contextiduint64El contexto para buscar el historial.
argumentsstringArgumentos que se proporcionaron con el comando por primera vez.



NOTA: Esta llamada requiere una clave de API de editor para utilizar este método. Como tal, esta API DEBE llamarse desde un servidor seguro, ¡y los clientes jamás pueden usarla directamente!

GetUserHistory

GET https://partner.steam-api.com/IGameInventory/GetUserHistory/v1/
NombreTipoObligatorioDescripción
keystringClave de autenticación de editor de la Web de API de Steamworks.
appiduint32Id. de aplicación del juego.
steamiduint64Id. de Steam para el que se obtiene la historia.
contextiduint64El contexto para buscar el historial.
starttimeuint32Hora de inicio del intervalo del historial a reunir.
endtimeuint32Hora de fin del intervalo del historial a reunir.



NOTA: Esta llamada requiere una clave de API de editor para utilizar este método. Como tal, esta API DEBE llamarse desde un servidor seguro, ¡y los equipos cliente jamás pueden usarla directamente!

HistoryExecuteCommands

POST https://partner.steam-api.com/IGameInventory/HistoryExecuteCommands/v1/
NombreTipoObligatorioDescripción
keystringClave de autenticación de editor de la Web de API de Steamworks.
appiduint32Id. de aplicación del juego.
steamiduint64La identificación del activo en el se opera.
contextiduint64El contexto para buscar la historia.
actoriduint32Id. 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. Por tanto, esta API DEBE llamarse desde un servidor seguro, ¡y los clientes jamás pueden usarla directamente!

SupportGetAssetHistory

GET https://partner.steam-api.com/IGameInventory/SupportGetAssetHistory/v1/
NombreTipoObligatorioDescripción
keystringClave de autenticación de editor de la Web de API de Steamworks.
appiduint32Id. de aplicación del juego.
assetiduint64La identificación del activo en el se opera.
contextiduint64El 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
NombreTipoObligatorioDescripción
keystringClave de autenticación de editor de la Web de API de Steamworks.
appiduint32Id. de aplicación del juego.
itemdefsJSON arrayUna o más definiciones de elementos, presentadas como una matriz JSON, para ser actualizadas o creadas.

Respuesta
La 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.