API/v1/events

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

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

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

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"
    }
  ]
}