API/v1

Die Version 1 der API ist die erste öffentliche API für Guild Wars 2 und erschien am 14. Mai 2013. Sie ist momentan als "beta" bezeichnet, was bedeutet, dass sich existierende Ressourcen in Zukunft ändern könnten, auch wenn die bisherigen Änderungen nur Erweiterungen waren. Diese erste Version der API sollte als "work in progress" betrachtet werden.

Endpunkte

Die Basis-URL für alle Endpunkte ist https://api.guildwars2.com/v1/

• build.json
• colors.json
• continents.json
• event_details.json
• event_names.json
• events.json
• files.json
• guild_details.json
• item_details.json
• items.json
• map_floor.json
• map_names.json
• maps.json
• recipe_details.json
• recipes.json
• world_names.json
• wvw/match_details.json
• wvw/matches.json
• wvw/objective_names.json

Fehlermeldungen

Fehler, welche aus falschen Eingabeparametern resultieren, melden einen HTTP/500-Statuscode, auch wenn ein HTTP/4xx-Status für Benutzerfehler angebrachter wäre. Die API-Server geben in diesem Fall ein JSON-Objekt zurück, welches unter anderem eine Fehlerbeschreibung im Klartext enthält. Eine Beispielanfrage ohne die erforderlichen Parameter an map_floor.json etwa liefert folgende Fehlermeldung:

{
  "error":10,
  "product":0,
  "module":4,
  "line":264,
  "text":"missing continent_id or floor"
}

Eine Anfrage an einen nicht existenten Endpunkt hingegen liefert wie zu erwarten einen HTTP/404 mit einer HTML-Fehlermeldung.