Erste Schritte
Alle folgenden Endpunkte verwenden API v2. Der Basispfad lautet /api/v2/public. Die Pfade in den Tabellen sind relativ zu diesem Präfix.
Listenparameter werden als JSON-Objekt im POST-Anfragetext mit Content-Type: application/json übergeben. Für eine ungefilterte Anfrage genügt {}. GET benötigt keinen Anfragetext. URL-Abfrageparameter wie ?page=… werden nicht unterstützt.
Senden Sie alle Anfragen an https://api.allodswiki.ru/api/v2/public. Die Pfade in den Tabellen sind relativ zu dieser Adresse. Mit dem Header X-Site: de.allodswiki.ru wählen Sie die deutsche Website und deren Spielversion aus. Eine direkte API-Anfrage ohne X-Site und Origin verwendet die russische Hauptwebsite allodswiki.ru.
Lesender Zugriff ist ohne Anmeldung innerhalb des Gastlimits möglich. Anwendungen können einen im Profil erstellten API-Token als Authorization: Bearer <token> senden. User-Agent muss exakt dem für den Token hinterlegten Wert entsprechen. Bis zur Freigabe gilt das Standardlimit, danach das vom Administrator zugewiesene Limit.
Ressourcen der Spieldatenbank
{id} ist die numerische Kennung der Ressource auf der Website. Sie wird auch in Listen und verknüpften Ressourcen zurückgegeben. Namen und Slugs aus den Seitenadressen der Website gehören nicht zum API-Pfad. Zurückgegeben werden nur veröffentlichte Ressourcen der gewählten Spielversion.
| Ressource | Liste | Details | Tooltip |
|---|---|---|---|
| Gegenstände | POST /items | GET /items/{id} | GET /items/{id}/tooltip |
| Quests | POST /quests | GET /quests/{id} | GET /quests/{id}/tooltip |
| NSC und Kreaturen | POST /mobs | GET /mobs/{id} | GET /mobs/{id}/tooltip |
| Objekte | POST /objects | GET /objects/{id} | GET /objects/{id}/tooltip |
| Gebiete | POST /zones | GET /zones/{id} | GET /zones/{id}/tooltip |
| Erfolge | POST /achievements | GET /achievements/{id} | GET /achievements/{id}/tooltip |
| Zauber | POST /spells | GET /spells/{id} | GET /spells/{id}/tooltip |
| Fähigkeiten | POST /abilities | GET /abilities/{id} | GET /abilities/{id}/tooltip |
| Fertigkeiten | POST /unlocks | GET /unlocks/{id} | GET /unlocks/{id}/tooltip |
| Währungen | POST /currencies | GET /currencies/{id} | GET /currencies/{id}/tooltip |
| Fraktionen | POST /factions | GET /factions/{id} | GET /factions/{id}/tooltip |
Listenparameter
Eine normale Liste liefert {"items": [...], "total": 123}. Eine Seite enthält höchstens 50 Einträge; die Seitennummerierung beginnt bei 1. total zählt alle Treffer vor der Seiteneinteilung. Die Seitengröße ist fest: limit, offset und page_size werden nicht verwendet.
| Feld | Wert und Bedeutung |
|---|---|
| page | Ganze Zahl ab 1; Standardwert 1. |
| search | Optionale Namenssuche mit 3 bis 256 Zeichen. Ohne Suche das Feld weglassen; eine leere Zeichenfolge ist ungültig. |
| desc | Boolescher Wert für die Sortierrichtung bei der Suche. Die meisten Listen ohne Suche sind nach Namen aufsteigend sortiert; Quests und Kreaturen haben eigene Optionen sort und desc. |
| quality | Nur /items: der Qualitätscode des Gegenstands, der im Antwortfeld quality verwendet wird. |
| level_min, level_max | Nur /quests und /mobs: optionale ganzzahlige Stufengrenzen. Eine einzelne Grenze genügt; die obere darf nicht kleiner als die untere sein. Bei Kreaturen wird die Überschneidung der Stufenbereiche geprüft. |
| sort | Nur /quests und /mobs: name oder level; desc bestimmt die Richtung. |
| faction | Nur /quests: league oder empire. Für alle Fraktionen das Feld weglassen; all ist kein gültiger Wert. |
Ränge und Erfolgsstufen
/abilities/{id}/tooltip und /spells/{id}/tooltip enthalten ein Array ranks. Für einen einzelnen Rang dienen die folgenden Endpunkte. {rank} ist eine positive Rangnummer ab 1.
{stage_id} eines Erfolgs stammt aus stages[].id seiner Detailantwort. Es handelt sich um eine Stufen-ID, nicht um deren Reihenfolge; sie wird nur zusammen mit der ID des übergeordneten Erfolgs verwendet.
| Methode und Pfad | Bedeutung |
|---|---|
| GET /abilities/{id}/ranks/{rank}/tooltip | Tooltip eines bestimmten Fähigkeitsrangs. |
| GET /spells/{id}/ranks/{rank}/tooltip | Tooltip eines bestimmten Zauberrangs. |
| GET /achievements/{id}/stages/{stage_id}/tooltip | Tooltip einer bestimmten Erfolgsstufe. |
Weltgeheimnisse
| Methode und Pfad | Bedeutung |
|---|---|
| POST /secrets | Vollständige Liste der Weltgeheimnisse; Anfragetext {}. Antwort {"items": [...]} ohne total und Seiteneinteilung. |
| GET /secrets/{id} | Details eines Weltgeheimnisses mit Abschnitten, Questgraphen und Belohnungen. Es gibt keinen eigenen Tooltip-Endpunkt. |
Talentplaner
| Methode und Pfad | Bedeutung |
|---|---|
| GET /character-classes | Klassenverzeichnis: {"data": [{"name": "…", "slug": "…"}]}. |
| GET /talents/{name} | Talentplaner der gewählten Klasse für die aktuelle Spielversion der Website. |
| GET /talents/{name}/layouts/{layout_id} | Eine bestimmte verfügbare Anordnung dieser Klasse. |
{name} ist der Wert slug aus /character-classes. Verwenden Sie layout.id aus der Planerantwort als {layout_id}. Diese undurchsichtige Kennung gehört zur jeweiligen Klasse und ist keine Spielversionsnummer.
Beide Planerendpunkte liefern name, point_budget, layout, spells, abilities, layers, fields und relations. layout enthält id und last_seen_version. layers beschreibt Talentreihen und Punkteanforderungen, fields die Rubinfelder und Startzellen, relations die Verknüpfungen zwischen Fähigkeiten und Zaubern. Verwenden Sie die Geometrie der Antwort statt fester Abmessungen.
Die Gruppen talents und rubies in point_budget enthalten level_free, level_subscription, total_free und total_subscription. Verwenden Sie diese Werte, denn die Punktebudgets hängen von der gewählten Spielversion ab.
Rüstkammer
| Methode und Pfad | Bedeutung |
|---|---|
| POST /armory/avatars | Bis zu 100 Charaktere nach Stufe und Ausrüstungswertung. Antwort {"items": [...], "servers": [...]} ohne Seiteneinteilung oder total. |
| GET /armory/avatars/{id} | Ein Charakter anhand seiner Charakter-ID auf der Website, einschließlich Ausrüstung und Aktualisierungszeit. |
POST /armory/avatars akzeptiert die optionalen Felder search, server und class_key. search ist ein genauer Charaktername mit höchstens 256 Zeichen ohne Beachtung der Groß-/Kleinschreibung; die russischen Buchstaben е und ё bleiben verschieden. server ist die Serverkennung aus servers[].id, class_key der Klassencode (slug aus /character-classes). Ohne Filter senden Sie {}.
Listeneinträge enthalten id, name, guild, level, gear_score, class, race, faction und server. class und race sind Codes, keine übersetzten Bezeichnungen. Verborgene oder gelöschte Charaktere und Server werden nicht zurückgegeben.
Die Detailantwort enthält zusätzlich greatness, updated_at und equipment. Jeder Ausrüstungseintrag enthält position, place und item. Fehlt ein Gegenstand in der Datenbank, ist item.id null und unknown true; seine Werte können trotzdem vorhanden sein. updated_at gibt die Zeit der Quelle ohne Zeitzonenversatz wieder.
Beispielanfragen
curl -X POST 'https://api.allodswiki.ru/api/v2/public/items' -H 'X-Site: de.allodswiki.ru' -H 'Content-Type: application/json' --data '{"page":1}'
curl -X POST 'https://api.allodswiki.ru/api/v2/public/quests' -H 'X-Site: de.allodswiki.ru' -H 'Content-Type: application/json' --data '{"page":1,"level_min":60,"level_max":70,"faction":"league","sort":"level","desc":true}'
curl 'https://api.allodswiki.ru/api/v2/public/character-classes' -H 'X-Site: de.allodswiki.ru'
curl 'https://api.allodswiki.ru/api/v2/public/talents/warrior' -H 'X-Site: de.allodswiki.ru'
curl -X POST 'https://api.allodswiki.ru/api/v2/public/armory/avatars' -H 'X-Site: de.allodswiki.ru' -H 'Content-Type: application/json' --data '{}'
Antworten und Limits
Erfolgreiche Anfragen liefern HTTP 200 und JSON ohne zusätzliche gemeinsame Hülle. Detail- und Tooltip-Felder hängen vom Ressourcentyp ab; Tooltips sind eigenständige, kleinere Antworten.
/zones/{id} kann HTTP 200 mit {"redirect_id": 123} liefern, wenn ein Untergebiet zu einem Hauptgebiet gehört. Setzen Sie den Abruf mit dieser ID fort.
Fehler haben das Format {"error": {"code": "…", "message": "…"}}. Bei HTTP 422 validation_failed enthält error.fields die Parameterfehler. HTTP 404 game_resource_not_found bezeichnet eine nicht verfügbare Ressource, armory_character_not_found einen Charakter und talent_layout_not_found eine Anordnung.
X-RateLimit-Limit gibt das aktuelle Anfragelimit an, X-RateLimit-Remaining die Anzahl verbleibender Anfragen. Warten Sie nach HTTP 429 too_many_requests entsprechend Retry-After; X-RateLimit-Reset enthält den Rücksetzzeitpunkt in Unix-Sekunden.