Difference between revisions of "WebAPI/GetAssetPrices"
< WebAPI
m (→Asset Name and Classes) |
|||
(2 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
== URL == | == URL == | ||
− | <nowiki>http://api.steampowered.com/ISteamEconomy/GetAssetPrices/v0001/</nowiki> | + | <nowiki>GET http://api.steampowered.com/ISteamEconomy/GetAssetPrices/v0001/</nowiki> |
− | |||
− | |||
== Method-specific Parameters == | == Method-specific Parameters == | ||
− | ; appid | + | ; appid (uint32) |
:The [[WebAPI#appids|ID]] of the game to query assets from. | :The [[WebAPI#appids|ID]] of the game to query assets from. | ||
− | ; language | + | ; {{API optional|language}} (string) |
:The [[Wikipedia:List of ISO 639-1 codes|ISO639-1 language code]] for the language all localized strings should be returned in. Not all strings have been translated to every language. If a language does not have a string, the English string will be returned instead. If this parameter is omitted the string token will be returned for the strings. | :The [[Wikipedia:List of ISO 639-1 codes|ISO639-1 language code]] for the language all localized strings should be returned in. Not all strings have been translated to every language. If a language does not have a string, the English string will be returned instead. If this parameter is omitted the string token will be returned for the strings. | ||
− | + | ;{{API optional|currency}} (string): The [[Wikipedia:ISO 4217|ISO 4217 code]] for currency specific filtering. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
== Result Data == | == Result Data == | ||
Line 49: | Line 17: | ||
:;assets: A list of items with slot '''tags''' and prices in the chosen or all currency. | :;assets: A list of items with slot '''tags''' and prices in the chosen or all currency. | ||
− | ::;prices: An array containing the currency code and respective price, if a '''currency''' is specified only that currency value will be present. | + | ::;prices: An array containing the currency code and respective price, if a '''currency''' is specified only that currency value will be present. <ref>All prices are given as integers due to issues regarding precision. A double value can be obtained by dividing the price by 100.</ref> |
::;{{API optional|original_prices}}: An array equivalent to '''prices''' in layout. Present when the item is on sale. | ::;{{API optional|original_prices}}: An array equivalent to '''prices''' in layout. Present when the item is on sale. | ||
− | ::;class: A list of properties attached to the item | + | ::;class: A list of properties attached to the item <ref>Note that for first party (Valve) games there may be a '''def_index''' property present, its value is a string that can be converted to an integer for use in [[../GetSchema|schema]] item lookups.</ref> |
:::;name: The name of the property. | :::;name: The name of the property. | ||
:::;value: The value of the property. | :::;value: The value of the property. | ||
Line 60: | Line 28: | ||
== Notes == | == Notes == | ||
− | + | <references/> | |
− | |||
− | |||
− | |||
− | |||
− | |||
[[Category:WebAPI|GetAssetPrices]] | [[Category:WebAPI|GetAssetPrices]] |
Latest revision as of 04:20, 21 October 2014
URL
GET http://api.steampowered.com/ISteamEconomy/GetAssetPrices/v0001/
Method-specific Parameters
- appid (uint32)
- The ID of the game to query assets from.
- language (Optional) (string)
- The ISO639-1 language code for the language all localized strings should be returned in. Not all strings have been translated to every language. If a language does not have a string, the English string will be returned instead. If this parameter is omitted the string token will be returned for the strings.
- currency (Optional) (string)
- The ISO 4217 code for currency specific filtering.
Result Data
- result
- success
- true if the query was successful, false otherwise.
- assets
- A list of items with slot tags and prices in the chosen or all currency.
- prices
- An array containing the currency code and respective price, if a currency is specified only that currency value will be present. [1]
- original_prices (Optional)
- An array equivalent to prices in layout. Present when the item is on sale.
- class
- A list of properties attached to the item [2]
- name
- The name of the property.
- value
- The value of the property.
- name
- The "name" of the asset. This has no set content besides that it is an identifier that can be used in URLs such as those for Valve's store frontend.
- classid
- The class ID of the item.
- tags
- An array containing information related to the item's slot or special attributes. See tags
- tags
- An array containing friendly names for the tags attached to items.
Notes
- ↑ All prices are given as integers due to issues regarding precision. A double value can be obtained by dividing the price by 100.
- ↑ Note that for first party (Valve) games there may be a def_index property present, its value is a string that can be converted to an integer for use in schema item lookups.