veröffentlicht am 12.10.2025
Wir haben heute Version 3.14.0 des Spiels veröffentlicht und damit ist die erste Version der API verfügbar.
Dieser Artikel richtet sich primär an die Entwickler und an alle, die verstehen wollen, was es damit auf sich hat.
Eine API ermöglicht es externen Anwendungen, wie einem Allianzmanager, auf das Spiel zuzugreifen, ohne dabei den Code der Seite (HTML) auslesen zu müssen. Es geht hierbei um einen einfacheren und kontrollierteren Zugriff.
Nicht jede externe Anwendung kann einfach so auf die Spieldaten zugreifen, dafür gibt es entsprechende Zugangsschlüssel. Jeder Spieler hat die Möglichkeit, Zugangsschlüssel anzulegen, um diese dann in einer externen Anwendung zu hinterlegen, damit diese dann auf die Daten zugreifen kann.
Diese Zugangsschlüssel können im Spiel in den Einstellungen unter "Account" > "Externe Anwendungen" erstellt werden. Dabei kann angegeben werden, welche Daten abgerufen werden können. Aktuell gibt es dort nur die Unterscheidung zwischen den eigenen Account-Daten und den Kampfberichten.
Die Zugangsschlüssel beginnen mit dem Namen des Universums, damit immer klar ist, für welches Universum der Schlüssel gültig ist. Das hilft den Spielern beim Eintragen und den Entwicklern beim Speichern in der eigenen Anwendung.
Über die Schnittstellen im Spiel können dann Daten abgerufen werden, die Auswahl ist zum aktuellen Zeitpunkt noch sehr begrenzt. Es soll erst einmal geprüft werden, ob die Entwickler mit dem Aufbau arbeiten können und ob überhaupt Interesse besteht, die Schnittstellen zu nutzen.
Die Schnittstelle der Account-Übersicht liefert allgemeine Informationen zum Account. Den Spielernamen, einen eindeutigen Wert zur Zuordnung, die Punkte, eine Übersicht der Planeten, sowie die Allianz und die Forschung.
Eine weitere Schnittstelle liefert detaillierte Angaben zu den Planeten des Spielers. Neben dem Namen, der Koordinate und den Punkten auch die Gebäude und die Rohstoffe. Hier kann entweder gezielt jeder einzelne Planet abgefragt werden oder alle Planeten des Spielers.
Über die Kampfberichtschnittstelle können die Informationen eines Kampfberichtes abgerufen werden. Dabei spielt es keine Rolle, um wessen Kampfbericht es sich handelt.
Wir bieten für alle PHP-Entwickler einen fertigen Client an, welcher mittels composer installiert werden kann. Für alle anderen haben wir einen Export der API nach OpenAPI-Standard.
Wir möchten erst einmal schauen, wie das Interesse an der API ist, um diese dann immer mal zu erweitern. Das Ziel ist es, mindestens alle Informationen aus der Gesamtübersicht über die API abzubilden.
Alle Informationen zur API sind auch in der Hilfe zu finden: API Intro