data.lotro.com - Now with items!

**Bracket** · Dec 10 2009, 03:19 PM

Hey developer types, with the launch of the update Lorebook comes a new data.lotro.com API method - item XML!

The basic URL pattern is described at http://data.lotro.com/ and looks like this:

Code:

http://data.lotro.com/{DEVELOPER_NAME}/{API_KEY}/item/id/{ITEMID}/

And the result XML will look something like this (pardon the poor indent formatting):

Code:

&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;apiresponse&gt;
 &lt;item id=&quot;1879094683&quot; name=&quot;Doom-hunter's Helm&quot; level=&quot;50&quot; type=&quot;Medium Armour&quot; quality=&quot;Incomparable&quot; unique=&quot;1&quot; isItemAdvancement=&quot;0&quot; stackSize=&quot;1&quot; bindOnAcquire=&quot;1&quot; bindOnEquip=&quot;0&quot; consumedOnUse=&quot;0&quot; cooldown=&quot;&quot; iconUrl=&quot;http://content.turbine.com/sites/lorebook.lotro.com/images/icons/item/head/eq_head_med_rift_set_1_hunter.png&quot; decoration=&quot;&quot; instrument=&quot;&quot;&gt;
&lt;requirements&gt;
&lt;level minimum=&quot;50&quot;/&gt;
&lt;gloryRank/&gt;
&lt;traits/&gt;
&lt;races/&gt;
&lt;classes&gt;
&lt;class name=&quot;Hunter&quot;/&gt;
&lt;/classes&gt;
&lt;factions/&gt;
&lt;/requirements&gt;
&lt;value baseCopperValue=&quot;1320&quot; gold=&quot;0&quot; silver=&quot;13&quot; copper=&quot;20&quot;/&gt;
&lt;durability points=&quot;50&quot; type=&quot;Tough&quot;/&gt;
&lt;damage/&gt;

&lt;armour value=&quot;218&quot;/&gt;
&lt;effects&gt;
&lt;effect value=&quot;+30 Will&quot;/&gt;
&lt;effect value=&quot;+8 Might&quot;/&gt;
&lt;effect value=&quot;+22 Maximum Morale&quot;/&gt;
&lt;effect value=&quot;+30 Agility&quot;/&gt;
&lt;effect value=&quot;+30 Vitality&quot;/&gt;
&lt;/effects&gt;
&lt;set name=&quot;Doom-hunter's Armour&quot; level=&quot;50&quot;&gt;
&lt;piece id=&quot;1879094678&quot;/&gt;
&lt;piece id=&quot;1879094679&quot;/&gt;
&lt;piece id=&quot;1879094680&quot;/&gt;
&lt;piece id=&quot;1879094681&quot;/&gt;
&lt;piece id=&quot;1879094682&quot;/&gt;
&lt;piece id=&quot;1879094683&quot;/&gt;
&lt;effect pieceCount=&quot;6&quot; value=&quot;25% Disperse Shadow Chance&quot;/&gt;
&lt;effect pieceCount=&quot;6&quot; value=&quot;-18% Penetrating Shot Power Cost&quot;/&gt;

&lt;effect pieceCount=&quot;4&quot; value=&quot;-50% Heart Seeker Power Cost&quot;/&gt;
&lt;effect pieceCount=&quot;4&quot; value=&quot;10% Disperse Shadow Chance&quot;/&gt;
&lt;effect pieceCount=&quot;2&quot; value=&quot;+15 Agility&quot;/&gt;
&lt;effect pieceCount=&quot;2&quot; value=&quot;3% Disperse Shadow Chance&quot;/&gt;
&lt;description&gt;&lt;![CDATA[This armour was granted as a reward for defending Eriador from the terror of N&Atilde;&raquo;rz G&Atilde;&cent;shu.]]&gt;&lt;/description&gt;
&lt;/set&gt;
&lt;description/&gt;
&lt;/item&gt;&lt;cache_info cached_until_gmt=&quot;2009-12-10 20:02&quot;/&gt;&lt;/apiresponse&gt;

The response will vary depending on the type of item. We do not have full documentation of the XML tag structure for each type of item but it should be fairly self-evident when looking at various types.

If you use this API, please make sure you only retrieve XML for an item once a day (or even less since these items will not be changing except for Lorebook updates). Additionally, if you want to do many lookups of lots of different items, make sure your script does not perform more than one request per second. Any developer or application that abuses these limits will find that their API key no longer works.

Please post here if you run into any problems, incorrect data, or have issues with the service.

**Beleg** · Dec 10 2009, 05:19 PM

Excellent, thanks!

Now if we could only get a list of all the items a character had (instead of what they happened to be wearing when they logged out) that would be great.

Hopefully gear in the character's packs will be available someday - though I understand that gear in the character's vault, shared vault, house, or escrow would be much harder.

FWIW, my hope would be able to produce a list of characters (in my kin) with how much Radiance they have. I can do this now, but only based on what they happened to be wearing - so it's not very accurate. Many people don't wear the radiance gear, except while raiding.

**Crystanor** · Dec 10 2009, 11:03 PM

Originally Posted by Beleg

FWIW, my hope would be able to produce a list of characters (in my kin) with how much Radiance they have. I can do this now, but only based on what they happened to be wearing - so it's not very accurate. Many people don't wear the radiance gear, except while raiding.

This is exactly the type of thing I've been trying to conceptualize as well. The best idea I've had this far is to keep track of the highest radiance I've seen a character with historically. Not that great still, but one step better than just using the number they happen to have at the moment you make a request. A great addition nonetheless and I'm glad there's continual developer support on this feature - thanks!

**Harlinator** · Dec 14 2009, 06:19 PM

Originally Posted by Beleg

Excellent, thanks!

Now if we could only get a list of all the items a character had (instead of what they happened to be wearing when they logged out) that would be great.

Hopefully gear in the character's packs will be available someday - though I understand that gear in the character's vault, shared vault, house, or escrow would be much harder.

FWIW, my hope would be able to produce a list of characters (in my kin) with how much Radiance they have. I can do this now, but only based on what they happened to be wearing - so it's not very accurate. Many people don't wear the radiance gear, except while raiding.

Ya this is hard to track. Basically I just keep track of the highest radiance value recorded each time I query for characters. Although, occasionally I will see a radiance value of 280 or some such.

However, I can't imagine that there would be public access to anyone Inventory but your own. I have been hoping that this would be done on my.lotro.com at some point.

**Harlinator** · Dec 14 2009, 08:48 PM

As for item ID numbers, they are not easily found anymore. These used to show up in the search results page on Lorebook, but now they do not. Is there an easy way to get a list of ID numbers?

**Biabo** · Dec 19 2009, 10:59 AM

I have to second the request for a way to determine the ID itself. Perhaps something like:

http://data.lotro.com/{DEVELOPER_NAME}/{API_KEY}/search/string/{url_encoded_item_name}

I realize it's likely you're, at least currently, exposing this API specifically for my.lotro character sheets, but some of us are chomping at the bit to be able to do stuff with recipes, etc.

I was able to find that if I looked in the history of a lorebook page and compared the last version, I could grab the item id from there, but that id doesn't seem to work for recipes (nor does /recipe/id/xxxx).

It's a great start Bracket, here's hoping to see more in this direction!

Frell

**Harlinator** · Dec 19 2009, 11:12 PM

In the lorebook thread, it was pointed out to me that the ID numbers exist, but it's not easily found. If you go to an item's lorebook page, click the 'View Source' link at the top to view the lorebook source for that page (*not* the HTML source code). The ID number can be found there. Or of you are logged into the Lorebook site, click the 'Edit' link.

Also, I have a list of at least 1011 items that give me errors. Some errors look like this (e.g. 1879087802):

Code:

&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;apiresponse>
 &lt;error message="Unknown error encountered." code="unknownError"/>&lt;/apiresponse>

Some look like this (e.g. 1879078831):

Code:

&lt;?xml version="1.0" encoding="UTF-8"?>
&lt;apiresponse>
 &lt;error message="Unable to retrieve item data." code="ItemFetchError"/>&lt;cache_info cached_until_gmt="2009-12-16 03:34"/>&lt;/apiresponse>

Is this a known issue? Would you like the list of IDs?

Harl

**Harlinator** · Dec 21 2009, 12:01 AM

I've done some investigating and it looks like items that have 'clickable' effects like the Amber Ring (ID= 1879115750) give error responses. Is this a known issue?

Thanks,
Harl

**Duwis** · Dec 21 2009, 09:16 AM

Originally Posted by Harlinator

Some errors look like this (e.g. 1879087802):

Some look like this (e.g. 1879078831):

Is this a known issue? Would you like the list of IDs?

For both examples, the issue is the data is not properly flagged as being publicly visible. You can PM me the list of IDs if you like, but we likely already know about most of them.

Originally Posted by Harlinator

I've done some investigating and it looks like items that have 'clickable' effects like the Amber Ring (ID= 1879115750) give error responses. Is this a known issue?

It is now; we'll add it to the TODO pile.

**Harlinator** · Dec 21 2009, 02:14 PM

That TODO guy gets a workout! Thanks for looking into these

Harl

**Duwis** · Jan 04 2010, 11:27 AM

Originally Posted by Harlinator

I've done some investigating and it looks like items that have 'clickable' effects like the Amber Ring (ID= 1879115750) give error responses. Is this a known issue?

Thanks,
Harl

OK, we've sorted out the Amber Ring issue; we'll try to get that fix out "Sapience Soon". We'll check other clickie items for similar issues, but if you have other examples, please drop them here or to me in a PM.

Thanks.

**Brushfire** · Jan 04 2010, 12:32 PM

Sapience Soon!?

That'll take forever! Can we get it Net Ops Soon?

Brushfire

**Gandolff** · Jan 06 2010, 06:04 PM

I know I am dense (yes flame away).. but how do I get the API key?

**Duwis** · Jan 06 2010, 07:27 PM

Originally Posted by Gandolff

I know I am dense (yes flame away).. but how do I get the API key?

See this post and this post by Bracket.

**Dinatius** · Jan 07 2010, 06:30 AM

Originally Posted by Gandolff

I know I am dense (yes flame away).. but how do I get the API key?

Developers are beyond flaming... we go straight for lasers

Very cool to see this added, Duwis and friends (that's assuming he didn't get stuck soloing). I've always appreciated how Turbine interacts with their community, it shows your dedication to your fans (we power you, after all!)

**TheStormKing** · Jan 08 2010, 08:32 PM

If only we could get a Deed XML feed, my life would be complete.

And so would be my offline roster.

**LagunaD** · Jan 09 2010, 04:30 AM

Originally Posted by Bracket

If you use this API, please make sure you only retrieve XML for an item once a day (or even less since these items will not be changing except for Lorebook updates). Additionally, if you want to do many lookups of lots of different items, make sure your script does not perform more than one request per second. Any developer or application that abuses these limits will find that their API key no longer works.

How would it be possible to distribute a desktop application that conformed to that rule?

Even if a given instance of an application is designed to be religious about caching and the one-query-per-second rule, multiple end-users, running on different machines with no knowledge of each other, could easily cause near-simultaneous requests with the application developer's API key to be received (and if you follow through on the threat to disable the key, all installations of the application anywhere would then cease to work...)

Edit: On a slightly related subject, I am seeing a 1-hour server cache-time indicated in the XML data I'm getting back from the server. Have I muffed the GMT time conversion somewhere? Or is the cached_until_gmt field wrong? Or is the period between updates shorter than 24 hours?

**Sparthir** · Feb 13 2010, 01:21 AM

Originally Posted by LagunaD

How would it be possible to distribute a desktop application that conformed to that rule?

Even if a given instance of an application is designed to be religious about caching and the one-query-per-second rule, multiple end-users, running on different machines with no knowledge of each other, could easily cause near-simultaneous requests with the application developer's API key to be received (and if you follow through on the threat to disable the key, all installations of the application anywhere would then cease to work...)

Edit: On a slightly related subject, I am seeing a 1-hour server cache-time indicated in the XML data I'm getting back from the server. Have I muffed the GMT time conversion somewhere? Or is the cached_until_gmt field wrong? Or is the period between updates shorter than 24 hours?

One way around it would be to host the feeds yourself and have your app talk your your storage. Also include a basic copy of the items with the app already of the items would be ideal because it would lighten your load etc.

**Harlinator** · Feb 22 2010, 10:44 AM

Originally Posted by Bracket

Hey developer types, with the launch of the update Lorebook comes a new data.lotro.com API method - item XML!

The basic URL pattern is described at http://data.lotro.com/ and looks like this:

Code:

http://data.lotro.com/{DEVELOPER_NAME}/{API_KEY}/item/id/{ITEMID}/

Bracket and Duwis,

Is there an easy way to get a list of all the LOTRO item IDs? I was wondering if you could create a special API method to return the ID list to rule them all. Something like:

Code:

http://data.lotro.com/{DEVELOPER_NAME}/{API_KEY}/items/

Where the XML result might look something like:

Code:

&lt;?xml version=&quot;1.0&quot; encoding=&quot;UTF-8&quot;?&gt;
&lt;apiresponse&gt;
  &lt;items&gt;
    &lt;id="1879094678"/&gt;
    &lt;id="1879094679"/&gt;
    &lt;id="1879094680"/&gt;
    &lt;id="1879094681"/&gt;
    &lt;id="1879094682"/&gt;
    &lt;id="1879094683"/&gt;
    .
    .
    .
  &lt;/items&gt;
&lt;cache_info cached_until_gmt=&quot;2009-12-10 20:02&quot;/&gt;&lt;/apiresponse&gt;

This list would only need to be updated when new items were added, etc. This would be a great help!

Thanks,
Harl

**Harlinator** · Feb 22 2010, 10:46 AM

Originally Posted by LagunaD

How would it be possible to distribute a desktop application that conformed to that rule?

Even if a given instance of an application is designed to be religious about caching and the one-query-per-second rule, multiple end-users, running on different machines with no knowledge of each other, could easily cause near-simultaneous requests with the application developer's API key to be received (and if you follow through on the threat to disable the key, all installations of the application anywhere would then cease to work...)

Edit: On a slightly related subject, I am seeing a 1-hour server cache-time indicated in the XML data I'm getting back from the server. Have I muffed the GMT time conversion somewhere? Or is the cached_until_gmt field wrong? Or is the period between updates shorter than 24 hours?

You could even have all your users get their own API key. Then you would not have to worry about this at all.

Harl

**HowardMac** · Feb 22 2010, 11:15 AM

Originally Posted by LagunaD

Even if a given instance of an application is designed to be religious about caching and the one-query-per-second rule, multiple end-users, running on different machines with no knowledge of each other, could easily cause near-simultaneous requests with the application developer's API key to be received (and if you follow through on the threat to disable the key, all installations of the application anywhere would then cease to work...)

I would be willing to bet that they would probably allow one request per second per IP with the same API key without shutting off your access. Just a thought.

**surgin77** · Mar 03 2010, 04:48 PM

Bracket...

I'm very excited to have access to data.lotro.com, having just discovered its existence. It is going to prove very useful to myself and my kin, many of whom are developers in their day jobs.

May I please have a developer name and API key?

Thanks.

-surgin77

**strangebaggins3** · Mar 04 2010, 05:27 PM

I have PM'd Bracket a couple times in the last month requesting an API key with no response. Is there a better way to get an API key?

**Garan** · Apr 20 2010, 10:20 AM

Originally Posted by LagunaD

Edit: On a slightly related subject, I am seeing a 1-hour server cache-time indicated in the XML data I'm getting back from the server. Have I muffed the GMT time conversion somewhere? Or is the cached_until_gmt field wrong? Or is the period between updates shorter than 24 hours?

The time in the field is current GMT (not UTC, be sure to watch out for daylight savings time which UTC does not use, probably the source of your 1 hour discrepancy) but the attiribute name is "cached_until_gmt" which implies it should be the time when the cache expires. I reported this to Bracket, not sure if the time is wrong or the attribute name is misleading.

**Garan** · Apr 20 2010, 10:24 AM

It seems that the Class LI slot items are not coming across. This might be an underlying data issue since I don't seem to see them on my.lotro.com either - for instance, my Mini's Songbook doesn't show in the data.lotro feed or my.lotro.com even though he's had a songbook in that slot months. The same for my Captain's Emblem and my LM's book. Not sure if this is a previously known issue but I went back a couple of pages on the forums lists and didn't notice any posts (doesn't mean it wasn't there and my bleary eyes just missed it... now, where's my coffee gone to?)

Thread: data.lotro.com - Now with items!

Thread Tools

Search Thread

Display

data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Re: data.lotro.com - Now with items!

Posting Permissions