Devuelve todos los registros de auditoría de un usuario en el periodo de tiempo especificado. El período de tiempo para regresar es cualquier evento después de
starttime pero antes de
endtime.
Llamada por: Herramienta de soporte
Método HTTP: GET
Parámetros:
| Nombre | Tipo | Obligatorio | Descripción |
|---|
| propietario | string | ✔ | Esta es la "Clave del servidor de recursos" que proporcionaste en la configuración de la economía de Steam de tu aplicación en el sitio de asociado. |
| appid | uint32 | ✔ | Id. de 32 bits de la aplicación asociada con el recurso. |
| steamid | uint64 | ✔ | Id. de Steam de 64 bits del usuario para el que se devuelven los recursos. |
| contextid | uint64 | ✔ | Id. de 64 bits del contenedor del contexto para el que se recuperan los recursos. |
| starttime | uint32 | ✔ | Momento de inicio del periodo para el que se devolverá el historial. El tiempo se expresa en segundos transcurridos desde 1/1/1970. |
| endtime | uint32 | ✔ | Momento de finalización del periodo para el que se devolverá el historial. El tiempo se expresa en segundos transcurridos desde 1/1/1970. |
Devuelve
La salida de este método debería estar codificada en formato JSON.
Respuesta: -
result
-
success - devuelve "true" si el método fue exitoso. Si el servidor de recursos devuelve "false", debería establecer error en una cadena que explique por qué.
-
error - una cadena que describe por qué falló esta llamada. Este mensaje se incluirá en el registro de errores, que está disponible en la pestaña "Economía" del sitio de Steamworks.
-
transactions - Vector de transacciones que tuvieron lugar en la cuenta del usuario en este contexto durante el intervalo de tiempo especificado.
-
timestamp - El momento en que este evento ocurrió. El tiempo se expresa en segundos transcurridos desde 1/1/1970.
-
action - Una breve descripción de esta transacción.
-
actor_steamid (opcional) - Id. de 64 bits de Steam del indicador de esta transacción.
-
action_steamid (opcional) - Id. de 64 bits de Steam del otro usuario involucrado en esta transacción
-
records - Vector de registros de información dentro de una transacción. Este registro podría representar recursos o cualquier otra unidad de cambio para el contexto.
-
action - El nombre de la acción realizada en esta transacción.
-
id (opcional) - Id. activo del activo.
-
name - El nombre del activo afectado por el registro.
-
url - Una URL con información relacionada para este registro.
-
icon_url(opcional) - El ícono a utilizar para este activo. Esta imagen deberá estar en formato JPEG, GIF o PNG, y tener un tamaño de al menos 96x96 píxeles. Es preferible usar PNG o GIF porque admiten transparencias. Steam aportará distribución CDN para todas las imágenes cuando se muestren a los usuarios, de modo que el número de clics en esta URL será relativamente bajo.
-
context_action (opcional) - Describe lo que pasó con este activo en el contexto en el que se encontraba como resultado de la acción. Los valores aceptables son: add, remove o modify.
-
prefix (opcional) - Cadena de prefijo para mostrar antes del nombre del activo en este registro.
-
color (opcional) - Una cadena de color hexadecimal RGB para usar para el prefijo.
-
has_details - True si IGameInventory/SupportGetAssetHistory devolverá datos válidos para este activo.
-
detail_appid (opcional) - El id. de la aplicación para buscar detalles. Solo es realmente útil si dos juegos están coordinando algún tipo de sistema común entre ambos. De forma predeterminada, se usa el mismo id. de aplicación del que procede el historial.
-
detail_context (opcional) - Id. de contexto de 64 bits del contexto para la búsqueda de detalles. De forma predeterminada, es el mismo que el de donde procede el historial de contexto.
-
commands Lista de comandos que se muestra en esta transacción en la herramienta de soporte.
-
name - Nombre del comando.
-
arguments - Cadena de argumento que se devuelve al servidor de recursos al llamar a GetHistoryCommandDetails. El servidor de economía de Steam no interpreta estos datos de manera alguna. Puede consistir en cualquier información que el juego necesite para identificar la transacción sobre la que ejecutar este comando.
Ejemplo de salida
{
"result": {
"transactions": [
{
"records": [
{
"action": "Timed Drop",
"id": 559964086,
"name": "Bushwacka",
"icon_url": "http://media.steampowered.com/apps/440/icons/c_croc_knife.ae304e977e7127b3ea5ddc862614b627604489a9.png",
"prefix": "Add",
"color": "55FF55"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAHhHs04AYWN0aW9ucwAAMQACYWN0aW9uAAcAAAAHaWQA\ntl9gIQAAAAAICAgIAA=="
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAHhHs04ICAA="
}
]
,
"timestamp": 1320372088,
"action": "Timed Drop: Points: 14114"
},
{
"records": [
{
"action": "Achievement Award",
"id": 556669733,
"name": "Bombinomicon",
"icon_url": "http://media.steampowered.com/apps/440/icons/bombonomicon.6dc3119f20faa08d10161fa876c57265ae46c282.png",
"prefix": "Add",
"color": "55FF55"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAPqqsE4AYWN0aW9ucwAAMQACYWN0aW9uAAMAAAAHaWQA\nJRsuIQAAAAAICAgIAA=="
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wAPqqsE4ICAA="
}
]
,
"timestamp": 1320200954,
"action": "Achievement Award: TF_HALLOWEEN_LOOT_ISLAND"
},
{
"records": [
{
"action": "Trade",
"id": 506851037,
"name": "Bushwacka",
"icon_url": "http://media.steampowered.com/apps/440/icons/c_croc_knife.ae304e977e7127b3ea5ddc862614b627604489a9.png",
"prefix": "Add",
"color": "55FF55"
},
{
"action": "Trade",
"id": 352354754,
"name": "Mann Co. Supply Crate",
"icon_url": "http://media.steampowered.com/apps/440/icons/crate.7299648976c7a022df68b7d35bf4a7cd05800855.png",
"prefix": "Remove",
"color": "FF5555"
},
{
"action": "Trade",
"id": 352354753,
"name": "Mann Co. Supply Crate",
"icon_url": "http://media.steampowered.com/apps/440/icons/crate.7299648976c7a022df68b7d35bf4a7cd05800855.png",
"prefix": "Remove",
"color": "FF5555"
}
]
,
"commands": [
{
"name": "Undo",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wANkejU4AYWN0aW9ucwAAMQACYWN0aW9uABgAAAAHaWQA\n3e41HgAAAAAIADIAAmFjdGlvbgAiAAAAB2lkAMKBABUAAAAACAAzAAJhY3Rpb24AIgAAAAdp\nZADBgQAVAAAAAAgANAACYWN0aW9uACIAAAAHaWQAFwwBHgAAAAAIADUAAmFjdGlvbgAiAAAA\nB2lkALVwYxkAAAAACAA2AAJhY3Rpb24AIgAAAAdpZADd\/5kWAAAAAAgANwACYWN0aW9uACIA\nAAAHaWQAr8WaFgAAAAAIADgAAmFjdGlvbgAiAAAAB2lkAAe9LhcAAAAACAA5AAJhY3Rpb24A\nIgAAAAdpZABcC\/wdAAAAAAgICAgA"
},
{
"name": "Rollback",
"arguments": "AGFyZ3VtZW50cwACdGltZXN0YW1wANkejU4ICAA="
}
]
,
"timestamp": 1317871321,
"action": "Trade",
"action_steamid": 76561198007577949
},
]
,
"success": true
}
}
