Roster:API
 |
Important note: When you edit this page, you agree to release your contribution into the public domain. |
Contents |
Roster API
The roster to wow api is a set of scripts that will use the new blizzard feeds for character and guild information from there servers for use with roster and its addons Features include
- Character info
- Basic information: name, level, class, race, gender, faction, guild, achievement points
- Optional fields: equipped items, stats, reputation, primary and secondary skills, achievements/statistics, talents, titles, collected mounts and companions, quests, profession recipes, Hunter pets, PvP information
- Guild
- Basic information: name, level, achievement points
- Optional fields: members (roster), achievements
- Arena Teams
- Basic information: name, ranking, rating, weekly/season statistics
- Optional fields: members (roster)
Char API
Used to pull info from the WoW Api About any given Character level 10 and up
Use: $roster->api->Char->getCharInfo('Zangarmarsh,'Ulminia','1:2:3');
Returns json formated arrays contaning data given from the array of fields listed below
The getCharInfo has 3 variables ($Server, $CharName, $Fields) respectfully.
- $Server - the name of the server the character is located on
- $CharName - the name of the character
- $Fields - the fields you want to get for this character use ":" to seperate multiple fields
The Field options are as fallows
- 1 (guild) - A summary of the guild that the character belongs to. If the character does not belong to a guild and this field is requested, this field will not be exposed.
- 2 (stats) - A map of character attributes and stats.
- 3 (talents) - A list of talent structures.
- 4 (items) - list of items equipted by the character. Use of this field will also include the average item level and average item level equipped for the character.
- 5 (reputation) - A list of the factions that the character has an associated reputation with.
- 6 (titles) - A list of the titles obtained by the character.
- 7 (professions) - A list of the character's professions. It is important to note that when this information is retrieved, it will also include the known recipes of each of the listed professions.
- 8 (appearance) - A map of values that describes the face, features and helm/cloak display preferences and attributes.
- 9 (companions) - A list of all of the non-combat pets obtained by the character.
- 10 (mounts) - A list of all of the mounts obtained by the character.
- 11 (pets) - A list of all of the combat pets obtained by the character.
- 12 (achievements) - A map of achievement data including completion timestamps and criteria information.
- 13 (progression) - A list of raids and bosses indicating raid progression and completedness.
- 14 (pvp) - A list of battleground vistories and teams.
- 15 (quests) - A list of completed quests by the character.
- 16 (feed) - A list of recent achievements items obtained, progression, statistics.
Guild API
Used to pull info from the WoW Api About any given Guild
Use: $roster->api->Guild->getGuildInfo($rname, $name, $fields);
Returns json formated arrays contaning data given from the array of fields listed below
The getGuildInfo has 3 variables ($rname, $name, $fields) respectfully.
- $ranme - the name of the server the guild is located on
- $name - the name of the Guild
- $Fields - the fields you want to get for this guild use ":" to seperate multiple fields
The Field options are as fallows
- 1 (members) - A summary of the guilds members.
- 2 (achievements) - an array of guild achievements completed (only id's given).
- 3 (news) - A list of recent guild news.
Guild rewards
$roster->api->Guild->getGuildrewards($rname, $name, $fields)
This returns a list of the rewards the specified guild has earned.
Data API
$roster->api->Data->getRacesInfo()
- This code returns a list of raceId's with faction alignment
$roster->api->Data->getQuestInfo($id)
- This code returns some info for a quest
"id":13157, "title":"The Crusaders' Pinnacle", "reqLevel":77, "suggestedPartyMembers":0, "category":"Icecrown", "level":79
$roster->api->Data->getClassesInfo()
- This returns id name and power type for all classes
$roster->api->Data->getItemInfo($itemID,$gem0=null,$gem1=null,$gem2=null,$enchant=null,$es=false)
- NOTE: $gem0,$gem1,$gem2,$enchant,$es are nto used as of yet
- Returns Json data for the formation of tooltips of the given item id.
$roster->api->Data->getAchievInfo()
- Returns the list of all achievements and catagories.
