Steamworks 文献库
GetAssetPrices/v0001
此 API 返回用户能够购买的物品的价格与类型。 如果指定有任何类筛选器,结果应筛选出含有至少一个指定的键/值对的返回物品。 例如,如果指定了 def_index/40def_index/50 两个筛选器,只有 def_index 类属性设为 40 或 50 的物品的结果才会被返回。

调用方: 网页购买

HTTP 方法: GET

参数:

名称类型是否必需描述
keystring这是在合作伙伴网站上,您在自己应用的 Steam 经济体设置中提供的“资产服务器密钥”。
appiduint32与资产相关联的应用程序的 32 位 App ID。
languagestring返回的结果所使用语言的 ISO639-1 语言代码加 ISO 3166-1 alpha 2 国家代码。 如 en_US、de_DE、zh_CN、ko_KR 等。 默认为无。
currencystring可选的 ISO 4217 货币代码。 若指定,只需返回指定币种的价格。
class_countuint32用于筛选的指定类标识符的数量。
class_name#string用于筛选的标识符名称。 在 0 和 class_count-1 之间的每个数字都有一个这类参数 (如,class_name0、class_name1、class_name2)。
class_value#string用于筛选的标识符的值。 在 0 和 class_count-1 之间的每个数字都有一个这类参数 (如,class_value0、class_value1、class_value2)。

返回

此方法的输出应为 JSON 格式。

响应:
  • result
    • success - 如果方法成功,为 true。 如果资产服务器返回 false,应将 error 设置为解释原因的字符串 。
    • error - 描述为何此调用失败的字符串。 这条消息将记录入错误日志,可在 Steamworks 站点的“经济体”选项卡下查看。
    • assets -可购买的一组资产。
      • id - 资产名称, 为将传入 StartWebAssetTransaction/v0001 的名称。
      • prices - 如果没有指明筛选币种,则含有支持的各币种的子元素。如果指明了筛选币种,则只包含该币种的价格。 各子键应为 ISO 4217 货币单位,其值应报告为无符号整数。 参见 支持币种,对如何报告此值了解更多。
      • original_prices - 如果此物品正在打折销售,这应该按 prices 的规则包含物品的原价。 如果物品不在打折,则需忽略此处。
      • class - 一组游戏定义的资产类标识符。 参见 GetContextContents/v0001,了解这些类标识符应采用的格式详情。
      • tags - 应用于物品的一组标签或类型。 参见输出示例,了解更多信息。 result 下的 tags 数组包含了各标签的本地化显示名称。
    • tags - 包含支持的各标签的子元素,不受指定筛选器影响。 如果指定了语言参数,此值应为本地化的文字。如果无指定语言,则为本地化令牌或其他标识符。

输出示例

以下为带有参数的请求输出示例:
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" }, } }