API/v1/events

Aus Guild Wars 2 Wiki
< API‎ | v1
Wechseln zu: Navigation, Suche
Hinweis Icon.png 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.
/v1/events.json
HTTP-Methode
GET
Format
JSON
API-Version
Version 1



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 anzeigen
  • map_id – nur Events auf dieser Karte anzeigen
  • event_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 stattfindet
  • map_id (number) – die ID der Karte
  • event_id (string) – die ID des Events
  • state (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]

https://api.guildwars2.com/v1/events.json?world_id=2005&event_id=AFCF031A-F71D-4CEA-85E1-957179414B25

{
  "events": [
    {
      "world_id": 2005,
      "map_id": 15,
      "event_id": "AFCF031A-F71D-4CEA-85E1-957179414B25",
      "state": "Inactive"
    }
  ]
}