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/
Nombre | Tipo | Obligatorio | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web de 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 el historial. |
arguments | string | ✔ | Argumentos 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/
Nombre | Tipo | Obligatorio | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web de 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 el historial. |
starttime | uint32 | ✔ | Hora de inicio del intervalo del historial a reunir. |
endtime | uint32 | ✔ | Hora 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/
Nombre | Tipo | Obligatorio | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web de 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. 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/
Nombre | Tipo | Obligatorio | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web de 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 | Obligatorio | Descripción |
key | string | ✔ | Clave de autenticación de editor de la Web de 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.