Documentación de Steamworks
Interfaz IGameInventory
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/
NombreTipoRequeridoDescripción
keystringClave de autenticación de editor de la Web 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 la historia.
argumentsstringArgumentos 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/
NombreTipoRequeridoDescripción
keystringClave de autenticación de editor de la Web API de Steamworks.
appiduint32Id. de aplicación del juego.
steamiduint64Id. de Steam para el que se obtiene la historia.
contextiduint64El contexto para buscar la historia.
starttimeuint32Hora de inicio del intervalo del historial que se debe reunir.
endtimeuint32Hora 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/
NombreTipoRequeridoDescripción
keystringClave de autenticación de editor de la Web 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. 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/
NombreTipoRequeridoDescripción
keystringClave de autenticación de editor de la Web 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
NombreTipoRequeridoDescripción
keystringClave de autenticación de editor de la Web 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.