Documentación de Steamworks
GetAssetPrices/v0001
Devuelve los precios y categorías de los artículos que pueden comprar los usuarios. Si se especifican filtros de clase, se deben filtrar los resultados allí donde los artículos contengan algunos de los pares clave-valor especificados. Por ejemplo, si se especifican dos filtros def_index/40 y def_index/50, solo se deben devolver los resultados de los elementos que tengan la propiedad de clase def_index establecida en 40 o 50.

Llamada por: Compras en la web

Método HTTP: GET

Parámetros:

NombreTipoRequeridoDescripció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 asociado.
appiduint32Id. de 32 bits de la aplicación asociada con el recurso.
idiomastringCódigo de lenguaje ISO639-1 más código de país ISO 3166-1 alfa 2 del lenguaje en que se devuelven los resultados. Algunos ejemplos incluyen en_US, de_DE, zh_CN y ko_KR. Predeterminado: ninguno
monedastringCódigo de divisa ISO 4217 opcional. Si se especifica, solo se deben devolver los precios para esta divisa.
class_countuint32Número de identificadores de clase especificados para el filtrado.
class_name#stringNombre del identificador que se filtra. 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 #stringValor del identificador que se filtra. Habrá uno de estos parámetros para cada número entre 0 y -1. (por ejemplo, class_value0, class_value1, class_value2)

Devoluciones

La salida de este método debería estar codificada en formato JSON.

Respuesta:
  • result
    • success - 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é 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.
    • assets - Vector de recursos que se pueden comprar.
      • name - El nombre del activo. Este es el nombre que se pasará a StartWebAssetTransaction/v0001.
      • prices - Contiene un elemento secundario para cada una de las divisas admitidas a menos que se especifique un filtro de divisa, en cuyo caso se debe incluir un precio solo para esa divisa. La clave de cada elemento secundario debe ser el código de divisa ISO 4217 y el valor debe comunicarse en forma de entero sin signo. Consulta Divisas admitidas para obtener más información sobre cómo informar este valor.
      • original_prices - Si este artículo está a la venta, contiene los precios de no venta del artículo de la misma manera que prices. Se omite si el artículo no está en oferta.
      • class - Una matriz de identificadores de clase de recursos definidos por el juego. Consulta GetContextContents/v0001 para obtener detalles sobre el formato que deben tomar estos indentificadores de clase.
      • tags - Una matriz de etiquetas o categorías que se aplican al elemento. Consulta el ejemplo de salida para obtener más información. La matriz etiquetas debajo de resultado contiene el nombre de visualización localizado para cada etiqueta.
    • tags - Contiene un elemento secundario para cada una de las etiquetas compatibles, independientemente de los filtros especificados. Los valores aparecerán como texto traducido si se ha especificado el parámetro de idioma, o como token de traducción u otro identificador en caso contrario.

Ejemplo de salida

La siguiente salida es un ejemplo de una solicitud con parámetros:
language=english&class_count=3&class_name0=def_index&class_value0=5021&class_name1=def_index&class_value1=58&class_name2=def_index&class_value2=647
{ "result": { "success": true "assets": [ { "name": "5021", "prices": { "USD": 249, "GBP": 199, "EUR": 199, "RUB": 7400 }, "class": [ { "name": "def_index", "value": "5021" } ] , "tags": [ "Tools" ] }, { "name": "58", "prices": { "USD": 74, "GBP": 44, "EUR": 55, "RUB": 2250 }, "original_prices": { "USD": 99, "GBP": 59, "EUR": 74, "RUB": 3000 }, "class": [ { "name": "def_index", "value": "58" } ] , "tags": [ "Weapons" ] }, { "name": "647", "prices": { "USD": 749, "GBP": 499, "EUR": 549, "RUB": 22400 }, "class": [ { "name": "def_index", "value": "647" } ] , "tags": [ "New", "Misc" ] } ] , "tags": { "Headgear": "Hats", "Misc": "Misc", "Weapons": "Weapons", "Tools": "Tools", "Collections": "Collections", "Bundles": "Bundles", "Maps": "Maps", "New": "New Releases" }, } }