API/v1/events
Zur Navigation springen
Zur Suche springen
![]() |
Hinweis: Durch die Einführung der Megaserver-Technologie ist dieser Endpunkt überflüssig geworden. Es gibt Pläne für einen Ersatz, jedoch keinen genauen Zeitplan dafür. Siehe auch: Stefan Larimore's Post im offiziellen Forum. |
Gibt eine Liste der Events zurück, die den Filterkriterien entsprechen. Die Filter können kombiniert werden. Die Informationen der API werden in Echtzeit aktualisiert.
Parameter[Bearbeiten]
- Optionale Parameter
world_id
– nur Events auf dieser Welt anzeigenmap_id
– nur Events auf dieser Karte anzeigenevent_id
– nur dieses Event anzeigen
Antwort[Bearbeiten]
Für jedes Event wird ein Objekt zurückgegeben, das neben Welt, Karte und Event-ID auch Informationen über den Status des Events enthält, welche folgendermaßen aufgeschlüsselt sind:
world_id
(number) – die ID der Welt in der das Event stattfindetmap_id
(number) – die ID der Karteevent_id
(string) – die ID des Eventsstate
(string) – Status des Events, welcher folgende Werte haben kann:Active
– Das Event läuft aktuell.Fail
– Das Event ist fehlgeschlagen.Inactive
– Das Event ist inaktiv und erfordert eine Aktion, damit es gestartet wird.Preparation
– Die Kriterien für den Start des Events sind erreicht, allerdings müssen noch einige Handlungen (z.B. ein NSC-Dialog) ausgeführt werden. Danach wird das Event aktiv (Active).Success
– Das Event wurde erfolgreich abgeschlossen.Warmup
– Das Event ist inaktiv und wird nur nach dem Eintreffen bestimmter Bedingungen aktiv (meist muss eine vorgegebene Zeit verstreichen).
Beispiel[Bearbeiten]
{ "events": [ { "world_id": 2005, "map_id": 15, "event_id": "AFCF031A-F71D-4CEA-85E1-957179414B25", "state": "Inactive" } ] }