Documentación de Steamworks
GetContextContents/v0001
Devuelve la totalidad de recursos y divisas en un contexto específico para un usuario.

Llamada por: IU de intercambio, IU de inventario

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.
steamiduint64Id. de Steam de 64 bits del usuario para el que se devuelven los recursos.
contextiduint64Id. de 64 bits del contexto para el que se devuelve el recurso.

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 los recursos que son secundarios del contexto especificado.
      • id - Id. de 64 bits del activo.
      • class - Vector de identificadores de clase de los recursos definidos por el juego. Es el juego para definir lo que
        esos identificadores son. Solo tienen que proporcionar información suficiente para reproducir la información de recursos
        (es decir, para describir qué clase de artículo es) cuando se devuelven los identificadores de clase a GetAssetClassInfo/v0001. Cada identificador debe contener los siguientes campos:
        • name - El nombre de esta parte del identificador de clase.
        • value - El valor de esta parte del identificador de clase como una cadena.
        • instance - Si esto es true, el identificador de clase se considera "instance data"; lo que significa que es
          por lo general; no se transfiere con el artículo en una transación, por lo que no se toma encuenta el valor comercial del artículo.
          (Por defecto: false)
          NOTA: Una propiedad de clase de activo que finalmente afecta al market_hash_name de un elemento en la GetAssetClassInfo/v0001 respuesta que nunca debería considerar datos de instancia. El Mercado de la Comunidad depende de las propiedades de la instancia que no tengan ningún efecto en market_hash_name.
        Para maximizar la cantidad de información descriptiva que puede almacenar Steam en la caché, los identificadores de clase deberían ser lo más genéricos y reusables posible. Por ejemplo, conviene evitar una clase que solo tenga una propiedad con un nombre como "itemid" y un valor que sea el id. de 64 bits del recurso. En su lugar, es mejor describir el tipo de artículo de un modo que ofrezca información suficiente para completar la descripción. Por ejemplo, una clase de recurso de "type" = "sword" y "rarity" = "common" proporciona información suficiente para elaborar la descripción del artículo aun sin saber exactamente de qué instancia del artículo se trata.
      • icon_url (opcional) - La pila cuenta para este activo. El usuario podrá intercambiar hasta dicho número de unidades de su pila. (Valor predeterminado: 1)
    • divisa (opcional) - Vector de los tipos de divisa que contiene este contexto. Si el usuario no tiene fondos en una determinada divisa, solo debe incluirse aquí cuando vaya a estar visible en la IU del juego. La visualización de la divisa es muy similar a la de un recurso, por lo que los campos mencionados anteriormente para recursos también se aplican a la divisa, con la excepción de los campos class y id. Además de los campos de recurso, para la divisa se emplean estos otros dos campos:
      • id - Id. de 32 bits sin signo asignado a este tipo de divisa. Este id. debe ser globalmente único en el juego.
      • amount - Número entero de 64 bits que representa la cantidad de este tipo de divisa que es propiedad del usuario.

Ejemplo de salida

{ "result": { "assets": [ { "id": 131363189, "class": [ { "name": "def_index", "value": "128" }, { "name": "quality", "value": "3" } ] }, { "id": 131412933, "class": [ { "name": "def_index", "value": "155" }, { "name": "quality", "value": "3" } ] }, { "id": 556669733, "class": [ { "name": "def_index", "value": "583" }, { "name": "flags", "value": "1" }, { "name": "origin", "value": "1", "instance": true } ] }, ] , "success": true } }