#1 - Aug. 27, 2012, 1:43 a.m.
We will be updating the documentation, but it might take a bit of time to get that done. Of course git push requests to the API documentation are always appreciated :)
Things to note: There will be changes in the coming weeks. Not only bug fixes but also new features. Some will be released prior to the expansion and some will come into play when the expansion hits. When pre-patch release hits your pets and mounts data won't be reliable. We plan to get these added back in as soon as possible and we know this is an inconvenience.
- Pandarens have three race ids. 24 is neutral, 25 is alliance pandaren and 26 is horde pandaren.
- There are some known bugs (on the website and API) with some of the tooltips and spell information. We will be fixing these asap.
- Account wide achievements will show up on all characters in an account.
- The biggest api change for the pre-patch is the format of character talents.
Achievement API Changes
Criteria now show a max and their order. Be aware that achievement and criteria id's might have changed and that criteria can now be shared between different achievements. If you have any code that looks up an achievement from criteria id it might need some work.
Achievements also have a new "accountWide" field to show if they are one of the account wide achievements (shown as blue headers in the game).
{
id: 2144,
title: "What a Long, Strange Trip It's Been",
points: 50,
description: "Complete the world events achievements listed below.",
reward: "Rewards: Violet Proto-Drake",
rewardItems: [
{
id: 44177,
name: "Reins of the Violet Proto-Drake",
icon: "ability_mount_drake_proto",
quality: 4,
tooltipParams: { }
}
],
icon: "achievement_bg_masterofallbgs",
criteria: [
{
id: 7553,
description: "To Honor One's Elders",
orderIndex: 0,
max: 1
},
...
],
accountWide: true
}
Character API Changes
The optional "stats" field no longer has a "resil" field but does have "pvpResilience" and "pvpResilienceRating" fields along with the new "pvpPower" and "pvpPowerRating" fields.
There are some fields spread around: "calcSpec", "calcClass", "calcTalent", and "calcGlyph" which can be combined to form links to the new talent calculator on the game site.
Please also remember (like I said above) that while some pet and mount data will show up, it might not be complete or accurate... we apologize.
The optional talents field however has the most changes. The talents themselves show where they are located in the new talent selector via a zero-indexed tier and column field. Here's what the new one looks like (this character doesn't have a second talent spec, so the second talent group is an example of what an empty one looks like):
talents: {
selected: true,
talents: [
{
tier: 0,
column: 0,
spell: {
id: 115173,
name: "Celerity",
subtext: "Passive Talent",
icon: "ability_monk_quipunch",
description: "Allows you to Roll and Chi Torpedo more often, increases their maximum number of charges by 1, and reduces their cooldown by 5 sec."
}
},
...
}
],
glyphs: {
major: [
{
glyph: 1015,
item: 85685,
name: "Glyph of Breath of Fire",
icon: "ability_monk_breathoffire"
},
...
],
minor: [
{
glyph: 1041,
item: 87888,
name: "Glyph of Fighting Pose",
icon: "ability_monk_dpsstance"
},
...
]
},
spec: {
name: "Windwalker",
role: "DPS",
backgroundImage: "bg-monk-battledancer",
icon: "spell_monk_windwalker_spec",
description: "A martial artist without peer who pummels foes with hands and fists.",
order: 2
},
calcTalent: "01.01.",
calcSpec: "b",
calcGlyph: "Vfp"
},{
talents: [ ],
glyphs: {
major: [ ],
minor: [ ]
},
calcTalent: "",
calcSpec: "",
calcGlyph: ""
}
The pet section no longer has talents, but has a spec choice (and a "calcSpec" field for the talent calculator):
pets: [
{
name: "MyPet",
creature: 57239,
selected: true,
slot: 0,
spec: {
name: "Tenacity",
role: "TANK",
backgroundImage: "bg-deathknight-blood",
icon: "ability_druid_demoralizingroar",
description: "",
order: 1
},
calcSpec: "Z"
},
...
]
The achievements field hasn't changed in structure but be aware that criteria aren't tied to one achievement anymore.
Progression data hasn't changed but be aware that achievements don't trigger site progression for the time being. If they did it would occur for all characters (account wide achievements) and we don't know if we want that yet. This means that you might need to go kill some of the old bosses if you haven't killed them since their statistics were added to the game.
Item API
The only change (that we know about now) is the addition of PvP Power as a bonus stat. Its id is 57. Some stats were deprecated and the old resilience is replaced with PvP Resilience.
---
Well that's it for now. Again there will be other changes and I'll try to communicate those as soon as we can. I apologize in advance if there are any differences from these posts and the final version. There may be some downtime on the API during the pre-patch release as well so be ready for that :)
If you have any other questions please ask, I'll try to answer as many as I can.