Item API does not include gems?

#1 - Aug. 10, 2012, 6:47 p.m.

I just was checking out the api with my characters. I noticed when i bring up an item via the item api i get this attribute for what i presume is socket data but its empty.

"socketEffects" : [ ],

if I do a link to the tool-tip I does have the socket info. but the api doesn't get me the data of the gems. Is this going to be fixed?

Korigus

Battle.net Developer

#2 - Aug. 10, 2012, 10:24 p.m.

That's correct. Right now there is no way to see what gems are socketed into the requested item via the API.

We will plan to add a new 'gems' field that returns an array of gems that shows what is socketed into the item and which bonus attribute(s) are applied by the gems.

It might look something like this:

{
 ....
 gems : [
 { 
 item : {
 slug: "chipped-emerald"
 ...
 },
 attributes : [ 
 "+6 Dexterity"
 ]
 attributesRaw: [
 "Dexterity_Item": 6
 ]
 }
 ]
 ....
}

And for reference, the 'socketEffects' array is only used to tell you how a certain gem behaves when socketed. So you will see this field contain data when you request info about a gem.
http://us.battle.net/api/d3/data/item/chipped-emerald

socketEffects: [
 {
 itemTypeId: "Helm",
 itemTypeName: "Helm",
 attributes: [
 "+5% Extra Gold from Monsters"
 ]
 },
 {
 itemTypeId: "Weapon",
 itemTypeName: "Weapon",
 attributes: [
 "Critical Hit Damage Increased by 10%"
 ]
 },
 {
 itemTypeId: "All",
 itemTypeName: "Other",
 attributes: [
 "+6 Dexterity"
 ]
 }
]