blizzard / api-wow-docs Goto Github PK

When getting the response for character progression, the Heart of Fear raid returns duplicate entry for Garalon.

Would it be possible to get realm queue status on the realm status call?

Hi,

I've come across this http://apiary.io/
which is a highly useful website.
As I've noticed there are a few people that comment here.
Maybe its useful to use ApiAry I use it on my work now :-)

Cheers

I'm looking for more details in the Spell APIs.
I've created process which scrapes data from wowhead, and I'd rather get the data from blizz's APIs for consistency.
I created an API from the wowhead data, here's the docs which explain what I'd love to see in the blizz API for spells:
http://api.wowguild.co/api/doc/#get--api-v1-spells-{id}

I often get these results

float(1247478960000) float(1247493360000) float(1247517540000) float(1247567820000) float(1247593380000)
Fatal error: Uncaught exception 'Exception' with message 'DateTime::__construct(): Failed to parse time string (1247685660) at position 8 (6): Unexpected character' in xx\blizzarsenal.php:31 Stack trace: #0 xx\blizzarsenal.php(31): DateTime->__construct('1247685660') #1 {main} thrown inxx\blizzarsenal.php on line 31

Whats that timestamps format?

Data generation

To generate the script, use s_bonusStatStringTags, BONUS_STAT_START, and BONUS_STAT_MAX from the client source tree (probably available in WoW/Source/Ui/GameUI.cpp but I can't be sure). If s_bonusStatStringTags is defined by brace initialization, you can probably copy-paste that and adjust the indexing at line 85 to read local mod = bonusStats[i + 1]. The script also requires Interface/FrameXML/GlobalStrings.lua from the appropriate localized client data directory to be present in the same directory when ran. From there it's just a matter of running the script and converting the tsv output to whatever format you wanna consume.

Documentation sample

Item Bonus Stats

The item bonus stats data API provides a mapping from bonusStat id to name.

URL: /api/wow/data/item/bonusStats

Example Data

• sample_18764.json

Any update on those? Is this still something you consider providing in the future?

It's missing data about the realm, the challenge mode itself, etc.

Application Registration

NOTE While we work on improving the authentication process we're no longer handing out api keys.
All anonymous requests have the same limit as a normal key.

Still true ?

Could you please add examples for the response headers?

For example, it would be really useful to know if the If at first you don't succeed, blow it up again. (too many requests) response contains a Retry-After header and what's the best practice to check if I'm still throttled (e.g. send HEAD or GET request?; request the server status for one server, a character without fileds or a short data resource?).

Unexpected response in http://us.battle.net/api/wow/item/77949, powerCost value may not be correct.

powerCost: "com.blizzard.battlenet.wow.spell.model.SpellPowerCost@4b38e209"

Either in the Character Races or the Character Classes data resource call. Could be helpful.

At least with libxslt 1.1.26 and docbook-xsl 1.75.2 on FreeBSD I have to invoke it as:

xsltproc --stringparam html.stylesheet style.css api-wow.xsl docbook-new.xml > index-new.html

Invoking it as

xsltproc api-wow.xsl --stringparam html.stylesheet style.css docbook-new.xml > index-new.html

gives me:

warning: failed to load external entity "--stringparam"
unable to parse --stringparam
warning: failed to load external entity "html.stylesheet"
unable to parse html.stylesheet
style.css:1: parser error : Start tag expected, '<' not found
html {
^
unable to parse style.css

Starcraft 2 should be StarCraft II

Fixed here:

{
    "abilities": [
        {
            "cooldown": 0, 
            "icon": "spell_shadow_plaguecloud", 
            "id": 640, 
            "isPassive": false, 
            "name": "Toxic Smoke", 
            "order": 1, 
            "petTypeId": 9, 
            "requiredLevel": 2, 
            "rounds": 1, 
            "showHints": false, 
            "slot": 1
        }, 
        {
            "cooldown": 0, 
            "icon": "ability_racial_rocketbarrage", 
            "id": 777, 
            "isPassive": false, 
            "name": "Missile", 
            "order": 0, 
            "petTypeId": 9, 
            "requiredLevel": 1, 
            "rounds": 1, 
            "showHints": false, 
            "slot": 0
        }, 
        {
            "cooldown": 0, 
            "icon": "inv_mace_02", 
            "id": 455, 
            "isPassive": false, 
            "name": "Batter", 
            "order": 3, 
            "petTypeId": 9, 
            "requiredLevel": 10, 
            "rounds": 1, 
            "showHints": false, 
            "slot": 0
        }, 
        {
            "cooldown": 0, 
            "icon": "inv_misc_pyriumgrenade", 
            "id": 636, 
            "isPassive": false, 
            "name": "Sticky Grenade", 
            "order": 2, 
            "petTypeId": 9, 
            "requiredLevel": 4, 
            "rounds": 1, 
            "showHints": false, 
            "slot": 2
        }, 
        {
            "cooldown": 0, 
            "icon": "ability_mount_rocketmount", 
            "id": 293, 
            "isPassive": false, 
            "name": "Launch Rocket", 
            "order": 5, 
            "petTypeId": 9, 
            "requiredLevel": 20, 
            "rounds": 1, 
            "showHints": false, 
            "slot": 2
        }, 
        {
            "cooldown": 0, 
            "icon": "inv_misc_bomb_09", 
            "id": 634, 
            "isPassive": false, 
            "name": "Minefield", 
            "order": 4, 
            "petTypeId": 9, 
            "requiredLevel": 15, 
            "rounds": 1, 
            "showHints": false, 
            "slot": 1
        }
    ], 
    "canBattle": true, 
    "creatureId": 42078, 
    "description": "Powerful artillery of the terran army. The Thor is always the first one in and the last one out!", 
    "icon": "t_roboticon", 
    "petTypeId": 9, 
    "source": "Promotion: StarCraft II: Wings of Liberty Collector's Edition", 
    "speciesId": 258
}

This query

http://eu.battle.net/api/wow/character/nathrezim/Inkpouch?fields=progression

produces this progress on Stone Guards in Mogu'Shan:

{"id":128288,"name":"Stone Guard","lfrKills":10,"lfrTimestamp":1350050859000,"normalKills":10,"normalTimestamp":0,"heroicKills":1,"heroicTimestamp":1357761053000}

As you can see the normalTimestamp value is null which really can't be because "normalKills":10. lfr and heroic timestamps are working fine.

I can observe the same problem with all the other guildmates. Other characters of the same realm are fine.

Is it possible to get the list of arena teams from a battle group with the players ?

Hello,

On EU realms, when downloading the batch from the URL returned by the /api/wow/auction/data/<realm> call, I get the data for another realm:

ownerRealm seems to be correct, but realm.name is not.

Example:

$ curl http://eu.battle.net/api/wow/auction/data/medivh                                                                                              
{"files":[{"url":"http://eu.battle.net/auction-data/57304a565824f2d778f9ad106430c98c/auctions.json","lastModified":1412860949000}]}%                                                                                                    

$ curl -s http://eu.battle.net/auction-data/57304a565824f2d778f9ad106430c98c/auctions.json | head
{
"realm":{"name":"Suramar","slug":"suramar"},
"alliance":{"auctions":[
        {"auc":1407583153,"item":82445,"owner":"Démoniakke","ownerRealm":"Medivh","bid":833200,"buyout":833200,"quantity":1,"timeLeft":"VERY_LONG","rand":0,"seed":75344768},
        {"auc":1407398207,"item":52721,"owner":"Meny","ownerRealm":"Medivh","bid":1500000,"buyout":1500000,"quantity":5,"timeLeft":"VERY_LONG","rand":0,"seed":587485066},
        {"auc":1408217593,"item":72234,"owner":"Wyskie","ownerRealm":"Medivh","bid":1399999,"buyout":1400000,"quantity":20,"timeLeft":"VERY_LONG","rand":0,"seed":1664512512},
        {"auc":1408136378,"item":83007,"owner":"Gàlly","ownerRealm":"Medivh","bid":391875,"buyout":412500,"quantity":1,"timeLeft":"LONG","rand":0,"seed":1840526976},
        {"auc":1407820417,"item":21877,"owner":"Telia","ownerRealm":"Medivh","bid":24000,"buyout":50000,"quantity":20,"timeLeft":"LONG","rand":0,"seed":1863355776},
        {"auc":1406696962,"item":42751,"owner":"Sîlentspy","ownerRealm":"Suramar","bid":3500000,"buyout":3500000,"quantity":1,"timeLeft":"LONG","rand":0,"seed":987790848},
        {"auc":1407764212,"item":82800,"owner":"Ducius","ownerRealm":"Medivh","bid":13250000,"buyout":14500000,"quantity":1,"timeLeft":"VERY_LONG","rand":0,"seed":1191489024,"petSpeciesId":145,"petBreedId":3,"petLevel":1,"petQualityId":2},

The biggest issue I've come across in navigating the API is having to figure out 1) what available fields there are in the API, and 2) what each of the fields mean.

A perfect example of this is in the character profile API's audit field. There are many fields, such as recommendedJewelcrafterGem, that don't appear for some characters, because they simply don't apply, and the documentation here does not list them all. Further, once a field has been found, I sometimes have a difficult time figuring out exactly what the field is used for. For example, I have no idea what lowLevelItems is supposed to be, because it is an empty object for every character I've tested it on so far.

I know it would be a rather large project, but it would be nice to have something that shows all of the possible fields and what they mean.

When I call the auction api 'us.battle.net/api/wow/auction/data/', all the pets' itemId are '82800',is it a defect?

http://us.battle.net/api/wow/character/{realm}/{character}?fields=items

sample output:

"mainHand":{
  "id":65007,
  "name":"Akirus the Worm-Breaker",
  "icon":"inv_mace_2h_grimbatolraid_d_01",
  "quality":4,
  "tooltipParams":{
    "enchant":4099,
    "reforge":159
  }
},

How is someone suppose to know how to make use of the reforge data? I don't understand 159 what? Maybe add another parameter, ex: "reforge_stat": "haste-hit" ?

In connected realms,we will access a single Auction House.I'd like to know that if the Auction API will be changed?How will it be?

My English is not good, hope you can understand what I mean.
Thanks!

Clicking an item in the navigation causes a full page reload, which takes about 12 seconds on my high end machine.

Windows 7 x64, Firefox 21.

I wanna to get the auction-data.json of a popular realm,but the json file(etc. http://www.battlenet.com.cn/auction-data/16b5c8ad6d4c1969761739bb1c95a622/auctions.json ) is too large to exceed the curl function limit of my server.

Could the API server compress the json file with gzip?

Best Regards.