Roster:API

Revision as of 22:31, 21 May 2012

Important note: When you edit this page, you agree to release your contribution into the public domain. If you do not want this or can not do this because of license restrictions, please do not edit.

Languages:

English  • Deutsch

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.

Realm API

Team API

Talent API