Difference between revisions of "WebAPI/GetPlayerItems"
(→Inventory Token: corrected information about inventory token, confirmed using API calls.) |
(→Result Data: account_info) |
||
Line 43: | Line 43: | ||
::;'''value''': The value for this attribute for this item (eg. the medal number for the [[Gentle Manne's Service Medal]]). | ::;'''value''': The value for this attribute for this item (eg. the medal number for the [[Gentle Manne's Service Medal]]). | ||
::;'''float_value''' ''(<span style="color: red;">Optional</span>)'': The floating point value for this attribute if it has one. | ::;'''float_value''' ''(<span style="color: red;">Optional</span>)'': The floating point value for this attribute if it has one. | ||
+ | ::;'''account_info''' ''(<span style="color: red;">Optional</span>)'': Set on attributes with a Steam id as the '''value'''. | ||
+ | :::;'''steamid''': The specified user's unique 64-bit Steam id. | ||
+ | :::;'''personaname''': The specified user's current name on Steam. | ||
== Inventory Token == | == Inventory Token == |
Revision as of 21:40, 30 August 2011
This method returns the specified player's backpack content.
This documentation is for version v0001 of GetPlayerItems.
URL
http://api.steampowered.com/IEconItems_<ID>/GetPlayerItems/v0001/
See the ID list for a valid ID.
Method-specific Parameters
- SteamID
- The 64 bit ID of the user the backpack will be retrieved for.
Status Codes
- 1: OK. Data returned as specified below.
- 8 ("SteamID parameter was missing"): The "steamID" parameter of the URL was not included, or if present was not a valid SteamID64 value.
- 15 ("Permission denied"): The player's profile is set to Private.
- 18 ("Unknown account"): The "steamID" parameter was not registered to an account.
Result Data
A list of the player's items is returned, as follows:
- num_backpack_slots
- The number of backpack slots this user has.
- items
- An object containing a list of associative arrays.
- id
- The unique ID of the specific item.
- original_id
- The id of the item before it was customized, traded, or otherwise changed.
- defindex
- The defindex of the item, as found in the item array returned from GetSchema.
- level
- The arbitrary "level" value of the item as displayed in the inventory.
- quantity
- The number of "uses" an item has, generally only has a value in excess of 1 on "Usable items" such as the Dueling Mini-Game.
- flag_cannot_trade
- A boolean value that is true if the item cannot be traded. This is true for items granted by an Achievement, purchased items, and certain promotional items.
- inventory
- An inventory token as described here, or 0 if the item has been awarded but not yet found (placed in the backpack).
- quality
- The quality of the item (see definition in GetSchema).
- custom_name (Optional)
- The item's custom name if it has one.
- custom_desc (Optional)
- The item's custom description if it has one.
- contained_item (Optional)
- All the information for the item that this item contains for gift-wrapped items.
- style (Optional)
- An integer that can be used as an index to the item's style list.
- attributes (Optional)
- If the item has additional effects to the ones normally associated with it as described in GetSchema, contains a list of associative arrays.
- defindex
- The index to the attributes definition in the schema. (eg. 133 for the medal number attribute for the Gentle Manne's Service Medal).
- value
- The value for this attribute for this item (eg. the medal number for the Gentle Manne's Service Medal).
- float_value (Optional)
- The floating point value for this attribute if it has one.
- account_info (Optional)
- Set on attributes with a Steam id as the value.
- steamid
- The specified user's unique 64-bit Steam id.
- personaname
- The specified user's current name on Steam.
Inventory Token
The inventory token is a combination of class loadout flags and position in the player's backpack. This unsigned 32 bit number is split into two two-byte words. The high word contains flags for each class. A 1 bit in a class's slot indicates that the items is equipped in the appropriate loadout slot for that class. The low word contains the backback position with 0 if the item has been awarded but not yet found (placed in the backpack), 1 being the upper left slot, 2 the second slot from the left on the top row, etc. Here it is visually:
┌─────────────────────────────────────────────────────────────── Always 1 │ ┌─┬─┬─┬─┬─┬─────────────────────────────────────────────────── Unused │ │ │ │ │ │ │ ┌───────────────────────────────────────────────── Engineer │ │ │ │ │ │ │ │ ┌─────────────────────────────────────────────── Spy │ │ │ │ │ │ │ │ │ ┌───────────────────────────────────────────── Pyro │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────────────── Heavy │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────────────── Medic │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────────── Demoman │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────────── Soldier │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─────────────────────────────────── Sniper (or Atlas) │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌───────────────────────────────── Scout (or P-Body) │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ ┌─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─┬─ Backpack Position │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ │ 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0
Examples:
1 0 0 0 0 0 0 0 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 0 1 Equipped Pyro item in backback slot 9 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 1 0 0 1 Unequipped item in backback slot 41 1 0 0 0 0 0 0 1 0 1 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0 1 0 1 0 Equipped by Pyro and Engy in backback slot 42
Languages: | English |