Roster:API/de
Important note: When you edit this page, you agree to release your contribution into the public domain. |
Contents |
Roster API
Die Roster API ist eine Sammlung von Skripten, welche dazu benutzt werden können um Informationen von Charaketeren und Gilden, zur Verwendung im Roster und in Addons aus dem Arsenal, abzufragen.
Features
- Charakter Info
- Basis Information: name, level, class, race, gender, faction, guild, achievement points
- Zusätzliche Felder: equipped items, stats, reputation, primary and secondary skills, achievements/statistics, talents, titles, collected mounts and companions, quests, profession recipes, Hunter pets, PvP information
- Gilde
- Basis Information: name, level, achievement points
- Zusätzliche Felder: members (roster), achievements
- Arena Teams
- Basis Information: name, ranking, rating, weekly/season statistics
- Zusätzliche Felder: members (roster)
Char API
Wird benutzt um Informationen zu einem angegebenen Charakter ab Level 10 abzufragen.
Anwendung: $roster->api->Char->getCharInfo('Zangarmarsh,'Ulminia','1:2:3');
Liefert ein Array im JSON Format mit den relevanten Daten der angegebenen Felder zurück.
Die Funktion getCharInfo erwartet 3 Variablen:
- $Server - Der Name des Realm auf dem der Charakter zu finden ist (ACHTUNG: auf die korrekte Schreibweise des Realmnamen achten)
- $CharName - der Name des Charakters
- $Fields - Die Felder, welche abgefragt werden sollen. Mehrere Felder können mit ":" getrennt werden.
Die Feld-Optionen sind wie folgt
- 1 (guild) - eine Zusammenfassung über die Gilde in welcher der Charakter ist. Ist der Charakter in keiner Gilde und das Feld wird trotzdem abgefragt, wird es ausgesetzt.
- 2 (stats) - eine Übersicht über die Attribute und Stats des Charakters.
- 3 (talents) - eine Liste der Talente des Charakters.
- 4 (items) - eine Liste mit allen angelegten Items des Charakters. Dieses Feld enthält ebenso das Allgemeine durchschnittliche Itemlevel und das durchschnittliche Itemlevel der angelegten Items..
- 5 (reputation) - eine Liste der Fraktionen bei dehnen der Charakter einen Ruf besitzt.
- 6 (titles) - eine Liste aller Charaktertitel.
- 7 (professions) - eine Liste der Berufe des Charakters.Es ist wichtig zu wissen das hierbei ebenfalls alle Rezepte / Pläne für jeden der Berufe mit abgerufen werden.
- 8 (appearance) - eine Liste welche Werte für das Aussehen des Charakters enthält (Gesicht, Helm und Umhang Anzeigeeinstellungen und Attribute).
- 9 (companions) - eine liste aller nicht Kampf Haustiere die der Charakter besitzt.
- 10 (mounts) - eine Liste aller Reittiere des Charakters.
- 11 (pets) - eine Liste aller Kampfhaustiere.
- 12 (achievements) - eine Liste der Erfolge, inklusive Zeitstempel und Erfüllungskriterien.
- 13 (progression) - eine Liste von Raids und Raidbossen, welche den aktuellen Raidfortschritt anzeigen.
- 14 (pvp) - eine Liste von Schlachtfeldbesuchen und Teams.
- 15 (quests) - eine Liste mit allen erledigten Quests.
- 16 (feed) - eine Liste mit den jüngst erhaltenen Erfolgsgegenständen, Fortschritt und Statistiken.
Gilden API
Kann benutzt werden um Informationen über eine angebene Gilde abzufragen.
Anwendung: $roster->api->Guild->getGuildInfo($rname, $name, $fields);
Liefert ein Array im JSON Format mit den relevanten Daten der angegebenen Felder zurück.
Die Funktion getGuildInfo erwartet 3 Variablen ($rname, $name, $fields) respectfully.
- $ranme - der Realmname auf welchem die Gilde zu finden ist
- $name - der Name der Gilde
- $Fields - die Felder, welche abgerufen werden sollen. Mehrere Felder werden durch ":" getrennt.
Die Feld-Optionen sind wie folgt:
- 1 (members) - eine Zusammenfassung der Gildenmitglieder.
- 2 (achievements) - ein Array mit erhalten Gildenerfolgen (nur die IDs werden übermittelt).
- 3 (news) - eine Liste der jüngsten Gildennews.
Gildenbelohnungen
$roster->api->Guild->getGuildrewards($rname, $name, $fields)
Dies liefert eine Liste mit allen Gildenbelohnungen zurück, welche die Gilde bisher erhalten hat.
Daten API
$roster->api->Data->getRacesInfo()
- Diese Funktion gibt eine Liste mit allen Rassen-IDs mit Fraktionszugehörigkeit zurück
$roster->api->Data->getQuestInfo($id)
- Diese Funktion liefert Informationen über eine angebene Quest
"id":13157, "title":"Der Kreuzfahrerturm", "reqLevel":77, "suggestedPartyMembers":0, "category":"Eiskrone", "level":79
$roster->api->Data->getClassesInfo()
- Diese Funktion liefert die ID und den Powertyp (Wut, Mana, Fokus) für alle Klassen
$roster->api->Data->getItemInfo($itemID,$gem0=null,$gem1=null,$gem2=null,$enchant=null,$es=false)
- Gibt ein JSON Array mit den Itemdaten der angebenen Item-ID zurück
$roster->api->Data->getAchievInfo()
- Gibt eine Liste aller Erfolge und Kategorien zurück.