Discussion: Furniture in players.inventory Staff Topic

Hey guys,

A small thing this, perhaps, but in the wake of allowing furniture to be auctioned we've just added a new section to the players.inventory API call which will list all of a player's furniture.

Broadly, it follows similar conventions to the rest of the item listings, but here are a few points that might cause questions...

 * Furniture listed is anything in a player's "furniture inventory"... furniture that is placed in a player's home is not included.
 * Each item has a special is_soulbound flag. Soulbound items can't be traded, auctioned etc.
 * Each item has an upgrades_count value... this includes all paid-for (ie, costs credits) upgrades, including the currently-active upgrade. Free upgrades aren't included since anyone can apply them to the item at any time.
 * Where items have been upgraded, the iconic_url_abs that appears in item_defs (if you call the method with defs=1) will be that of the upgrade, not the base furniture item.
 * Unlike normal inventory items, furniture items don't include a path_tsid, since behind the scenes they all live in one big "bag".
 * Items that have more than one paid-for upgrade will have the basic details of those upgrades (name, swf, iconic url) listed in extra_upgrades ... note, this section does not include the currently-active upgrade, which is reflected in the item label/iconic etc.

That should be all that you need to know, but please add questions, comments etc. here.
Yay, API is alive! Keep em coming' :]
Yay! I was hoping for just this.

I have a comment on returning only paid upgrades in the api method. This is inconsistent with the auction listings for furniture, where all (free-for-all + free-for-subscribers + paid) upgrades are indicated.

I actually prefer how it is done in the auctions.

Also, I find the definition for "paid-for" upgrades as costing credits rather narrow. Subscriber-only 0-credit upgrades are not really "free" since not everyone can apply them at any time.

On a related note, it would be good if auctions.list can return proper labels for furniture listings. There is no way presently to identify an upgraded item.
*Party for the API* :D
Thanks for maintaining the API!