# Intro

# Übersicht

Das Spiel bietet ab Version 3.14.0 eine API an. Über diese API können Informationen über den eigenen Spielaccount abgerufen werden. Zusätzlich können auch gezielt Kampfberichte abgerufen werden.

# Authentifizierung

Die Authentifizierung läuft auf Tokenbasis über den Header x-auth-token.

# API-Tokens

Tokens können vom Spieler im Spiel in den Einstellungen unter "Account" und dort unter "Externe Anwendungen" erstellt werden. Bei der Erstellung eines neuen Tokens können Berechtigungen ausgewählt werden.

Um die Tokens der verschiedenen Anwendungen zu unterscheiden, haben diese einen Prefix des jeweiligen Universums. Diese Information kann zusätzlich genutzt werden, um zu prüfen, dass der Spieler im korrekten Universum einen Token erstellt hat.

# Konstanten

Wir haben in der API diverse Bezeichner für Gebäude, Forschungen, Schiffe, Türme und mehr. Um damit leichter arbeiten zu können, gibt es hier eine Liste aller Konstanten.

Diese sind auch im PHP-Client (opens new window) zu finden.

# Gebäude

commandCenter
researchCenter
tradingPost
ironMine
lutinumRefinery
drillingTower
chemicalFactory
extendedChemicalFactory
ironStorage
lutinumStorage
waterStorage
hydrogenStorage
shipFactory
orbitalDefenceStation
planetaryShield
fusionReactor

# Forschungen

combustionDrive
ionDrive
spaceCurvatureDrive
spaceFoldingDrive
ionisation
energyBundling
explosiveProjectiles
spyTechnology
extendedShipArmour
increasedCargoCapacity
recyclingTechnology

# Schiffe

schakal
recycler
spySatellite
renegade
raider
falcon
colonisationShip
tjuger
cougar
longeagleV
smallTrader
largeTrader
noah
longeagleX

# Verteidigungsanlagen

lightLaserTower
laserTower
empLauncher
plasmaTower
rocketDefenseCannons

# Spieler

user
observer
npc
free_nation