Documentación de Steamworks
GetAssetClassInfo/v0001
Devuelve los detalles necesarios para mostrar una clase de recurso a un usuario. El método se utilizará al menos una vez para cada recurso que aparezca en el inventario de un usuario. Hace un uso extensivo de la caché, así que puede llamarse con mucha menos frecuencia por visualización de recurso. Si hay que invalidar la caché por cualquier razón, se puede cambiar la versión de la clase de recurso en la pestaña "Economía" de los detalles técnicos de la aplicación.

Normalmente, los identificadores de clase los describe solo el juego en el que existe el recurso. La única excepción es la divisa. El servidor de economía de Steam puede llamar a la función GetAssetClassInfo con un solo identificador llamado "currencyid", con un valor igual al id. de la divisa que debe consultar. En este caso, el servidor de recursos debe devolver detalles de visualización de divisa en lugar de detalles de visualización de recurso.

Llamada por: IU de inventario

Método HTTP: GET

Parámetros:

NombreTypeObligatorioDescripción
keystringEsta 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.
appiduint32Id. de 32 bits de la aplicación asociada con el recurso.
class_countuint32El número de identificadores de clase especificados.
class_name#stringEl nombre del identificador. Habrá uno de estos parámetros para cada número entre 0 y class_count-1. (por ejemplo, class_name0, class_name1, class_name2)
class_value #stringEl valor del identificador. Habrá uno de estos parámetros para cada número entre 0 y class_count-1. (por ejemplo, class_value0, class_value1, class_value2)
languagestringCódigo de idioma ISO639-1 más código de país ISO 3166-1 alfa 2 del idioma en que se devuelven las cadenas. Algunos ejemplos incluyen en_US, de_DE, zh_CN y ko_KR. Por defecto: en_US

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.
    • asset - Un objeto que contiene detalles de visualización para los identificadores de clase de recursos especificados.

Detalles de visualización:

  • background_color - Un valor de color hexadecimal RGB representado como una cadena.
  • icon_url - El ícono a utilizar para este recurso. Esta imagen debe estar en los formatos JPEG, GIF o PNG.
    Es preferible PNG o GIF porque admiten transparencia. Los juegos pueden proporcionar un tamaño de ícono con este campo y Steam lo ajustará para que encaje en la IU si es necesario. El ícono debe tener un tamaño mínimo de 200x200 píxeles. 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.
  • icon_url_large (opcional) - El ícono grande asociado a las descripciones. Las reglas de formato de imagen son las mismas que icon_url.
    Este ícono grande debe de tener un tamaño mínimo de 330x192 píxeles. Si no se proporciona icon_url_large, icon_url será utilizado en su lugar.
    Steam proporcionará distribución de CDN para todas las imágenes cuando se muestren a los usuarios, por lo que el número de visitas a esta URL será relativamente bajo.
  • descriptions - Vector de las descripciones que se mostrarán para el recurso. Se mostrarán en el siguiente orden
    aparecen en la matriz en descripciones emergentes y en descripciones detalladas de los artículos.
    • type (opcional) - El campo type controla cómo se representa el campo de value.
      pueden ser cualquiera de los siguientes valores:
      • text - Interpretará el valor como texto traducido en el idioma especificado. Algunos caracteres (menor que, mayor que, etc.) se convertirán en entidades HTML para que no se les interprete como etiquetas. Cada caracter de salto de línea se convertirá en <br>.
        Esto se debe utilizar para los datos proporcionados por el usuario. Si no especificas ningún tipo text es el predeterminado.
      • html - El valor se incluirá en la página como HTML con las etiquetas intactas.
    • image - Value es la URL de una imagen para mostrar esta descripción. Steam pondrá un CDN delante de la imagen, así que el número de clics en esta URL será relativamente bajo.
    • image - String traducido para mostrar esta descripción.
    • color (opcional) - Un color hexadecimal RGB para usar en el valor. El color que aparezca en esta información se usará en la IU del juego. Este campo solo se aplica a los valores del tipo text.
    • label (opcional) - Si este campo está presente, el valor de la descripción será prefijado con esta etiqueta.
  • tags (opcional): un vector de etiquetas que se aplican al recurso. El usuario las ve como opciones de filtrado en distintos lugares de la IU, incluido el Mercado de la Comunidad y el inventario.
    • internal_name - Un nombre para identificar esta etiqueta. El usuario no verá el nombre interno. No utilices espacios, caracteres que no sean ASCII ni caracteres imprimibles en el campo internal_name.
    • name - El nombre localizado de esta etiqueta. El usuario lo verá.
    • category - La categoría para colocar esta etiqueta. Se usa solo internamente con fines de clasificación y el usuario no lo verá. No utilices espacios, caracteres que no sean ASCII ni caracteres imprimibles en el campo categoría.
    • category_name - El nombre localizado por la categoría. El usuario lo verá.
    • color (opcional) - Un color hexadecimal RGB para usar cuando se muestra el nombre de la etiqueta.
  • tradable (opcional) - Si es "true", el objeto aparecerá en la interfaz de usuario comercial. (Predeterminado: "false")
  • marketable (opcional) - Si es "true", el artículo podrá ser vendido en el Mercado de la Comunidad de Steam. (Por defecto: "false").

    NOTA. Las listas del Mercado de la Comunidad actualmente no se pueden probar. Al incluir un artículo en un listado del Mercado de la Comunidad, este quedará expuesto de inmediato, aunque la economía del juego lo marque como privado.
  • market_name (obligatorio si es comercializable) - Si el artículo es comerciable, este es el nombre que se usará para agruparlo y el que aparecerá en el Mercado de la Comunidad. Siempre que sea posible, se debe traducir.
  • market_hash_name (obligatorio si es comercializable) - Esto siempre debe de tener el valor en inglés market_name. Se usa para poner en correlación las distintas versiones y mostrar el historial de información y otros datos.
  • market_fee (opcional) - Si el artículo es comercializable, la cantidad de la transacción (10 % por defecto) se tomará como la tarifa del juego. Esta tarifa se paga al comprador del artículo en el momento de la transacción y se remite al editor como parte de su pago mensual. Se expresa como un decimal entre 0 y 0.95 (aunque se recomienda un valor razonable) (Valor predeterminado: 0.10).
  • commodity (opcional) - Indica que todos los artículos con el mismo market_hash_name que este artículo son exactamente iguales. Desde el punto de vista de los usuarios, no debe haber ninguna diferencia. Esto cambia la IU del Mercado de la Comunidad para este tipo de artículo y permite a los usuarios hacer pedidos. El usuario no tiene control sobre a quién le está comprando ni a qué lista de mercado está comprando, por eso es importante que todos los artículos con el mismo market_hash_name sean idénticos cuando commodity es "true". (Predeterminado: "false").
  • market_tradable_restriction (opcional) - La cantidad de días que el artículo no podrá ser comercializado después de la compra. Puede que sea conveniente imponer una restricción comercial a los artículos adquiridos para reducir la posibilidad de que se comentan fraudes con tarjetas de crédito. Los juegos de Valve usan un valor de 7. (Por defecto: 0)
    NOTA. Este valor no es autoritario. Steam no impone esta restricción. El valor del campo solo se usa para informar a los usuarios de que existe una restricción. Una vez comprado un artículo, le corresponde al servidor de recursos imponer la restricción comercial al artículo. El servidor de recursos puede hacer esto cuando se llama a TradeSetOwned/v0001 y is_market está establecido como 1 y audit_action como 101.
  • market_marketable_restriction (opcional) - Al igual que market_tradable_restriction, pero indica el número de días que el artículo no será comercializable después de la compra. Los juegos de Valve usan un valor de 7. (Por defecto: 0)
    NOTA. Este valor no es autoritario. Steam no impone esta restricción. El valor del campo solo se usa para informar a los usuarios de que existe una restricción. Una vez comprado un artículo, le corresponde al servidor de recursos imponer la restricción comercial al artículo. El servidor de recursos puede hacerlo cuando se llama a TradeSetOwned/v0001 y is_market se establece como 1 y audit_action como 101.
  • actions - Vector de acciones (enlaces) usadas normalmente para mostrar más información sobre un recurso. Aparecen como botones bajo la descripción, en la página del inventario. Los enlaces se abren en el navegador predeterminado del usuario.
    • link - La URL para navegar cuando se hace clic en el botón. Los tokens %assetid%, %contextid% y %appid% serán reemplazados por el id. de recurso, el id. de contexto y el id. de aplicación propietaria del recurso, respectivamente.
    • name - La etiqueta para mostrar en el botón.
  • owner_descriptions - Una matriz de descripciones que solo se muestran al propietario del recurso. Los contenidos de esta matriz son exactamente iguales a los de descriptions. La única diferencia entre ambas listas es la identidad de quienes pueden ver las descripciones.
  • owner_actions - Una serie de acciones que se muestran solo al propietario del recurso. El formato debe ser el mismo que actions. Representan acciones especiales disponibles solo para el propietario del recurso, como activarlo o modificarlo.
  • fraudwarnings - Una serie de cadenas de advertencias de fraude para mostrar si el artículo se agrega a una venta.
    Estos se muestran en rojo si el artículo se agrega a una venta.
  • name - La primera fila de la visualización del artículo.
  • name_color - Un color hexadecimal RGB para usar en el nombre. Debe coincidir con los códigos cromáticos de calidad o frecuencia usados por los nombres de los recursos en el juego.
  • name - La segunda fila de la visualización del artículo.
  • contained_item (opcional) - Este nodo debe contener un bloqueo de recursos completo para un artículo contenido dentro de este recurso. Los juegos Source lo usan para los regalos sin abrir, aunque puede ser que no se aplique al tuyo.
  • cache_expiration (optional) - RFC 3339 UTC con formato de tiempo en que la memoria caché de Steam de la respuesta debe ser invalidada. Solo se usa si cualquier parte de la respuesta de GetAssetClassInfo va a cambiar posteriormente sin que lo haga el conjunto de propiedades de la clase de recurso. Esto resulta útil, por ejemplo, si el artículo se vuelve comerciable posteriormente. Se recomienda redondear el tiempo en las propiedades de la clase de recurso (y, por ende, en este campo) en términos de días u horas para mejorar la capacidad de Steam de almacenar en la caché las descripciones de los recursos.
  • item_expiration (opcional) - Momento en formato RFC 3339 UTC en el que el artículo ya no puede utilizarse. Los listados del Mercado no podrán comprarse pasado este momento y se cancelarán automáticamente.

    Ejemplo de salida

    { "result": { "asset": { "descriptions": [ { "name": "attribute", "value": "+50% fire damage resistance on wearer", "color": "99ccff" }, { "name": "attribute", "value": "+40% explosive damage resistance on wearer", "color": "99ccff" }, { "name": "attribute", "value": "Alt-Fire: Gain increased attack power by\ncharging toward your enemies." } ] , "fraudwarnings": [ "This item has been renamed.\nOriginal name: \"Chargin' Targe\"" ] , "tradable": true, "background_color": "3C352E", "icon_url": "http://media.steampowered.com/apps/440/icons/c_targe_large.b7d8c75ecfc9b04cc49d2c61ddc77996d7ec2f3a.png", "name": "''Awesome Targe''", "type": "Level 10 Shield", "name_color": "7D6D00", "actions": [ { "name": "Item Wiki Page...", "link": "http://wiki.teamfortress.com/scripts/itemredirect.php?id=131&lang=en_US" } ] }, "success": true } }

    economy_asset_tooltip.png

    economy_asset_icon.png