Difference between revisions of "WebAPI/GetAssetPrices"
< WebAPI
(There is an easter egg here. Find it. I dare you) |
|||
| (7 intermediate revisions by 4 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: | |
| − | ;success: '''true''' if the query was successful, '''false''' otherwise. | + | :;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. | + | :;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. | |
| − | :;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. |
| − | :;classid: The [[../GetAssetClassInfo|class ID]] of the item. | + | ::;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. |
| − | :;tags: An array containing information related to the item's slot or special attributes. See '''tags''' | + | ::;classid: The [[../GetAssetClassInfo|class ID]] of the item. |
| − | ;tags: An array containing friendly names for the tags attached to items. | + | ::;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 == | == 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.
