API

Aus Guild Wars 2 Wiki
Wechseln zu: Navigation, Suche

Die API ist eine offizielle Programmierschnittstelle, um Informationen zu Spielinhalten und deren aktuellen Status zur Abfrage in externen Anwendungen zur Verfügung zu stellen. Die Verwendung der API steht unter zusätzlichen Bedingungen, die im englischen Wiki zusammen mit der vollständigen Dokumentation in englischer Sprache eingesehen werden können. Eine Übersetzung der Dokumentation findet sich im Folgenden.

Die API wird über HTTPS unter der URL https://api.guildwars2.com/ zur Verfügung gestellt. Sie ist eine REST-Schnittstelle, die auf Anfragen per HTTP-GET antwortet. Alle Antworten sind in JSON formatiert.

Version 2[Bearbeiten]

Die Version 2 der API bietet folgende Endpunkte:

Welt- und Karteninformation[Bearbeiten]

Die folgenden Endpunkte liefern Informationen, welche in Verbindung mit dynamischen Events, Welt gegen Welt oder dem Kachel-Service genutzt werden können:

Dynamische Events[Bearbeiten]

Gegenstände[Bearbeiten]

  • /v2/items - eine Liste mit IDs der bisher entdeckten Gegenstände und Details dazu
  • /v2/materials - eine Liste mit IDs der bisher entdeckten Materialien und Details dazu
  • /v2/minis - eine Liste mit IDs der bisher entdeckten Miniaturen und Details dazu
  • /v2/recipes - eine Liste mit IDs der bisher entdeckten Rezepte und Details dazu
    • /v2/recipes/search - Generiert automatisch alle Rezept-IDs in denen ein Gegenstand vorkommt (Output oder Input)
  • /v2/skins - eine Liste mit IDs der bisher entdeckten Skins und Details dazu

Welt gegen Welt[Bearbeiten]

Handelsposten[Bearbeiten]

Account- und Charakterinformationen[Bearbeiten]

Erfolge[Bearbeiten]

Gilden[Bearbeiten]

Strukturiertes PvP[Bearbeiten]

  • /v2/pvp - persönliche PvP-Informationen (authentifiziert)
    • /v2/pvp/games - eine Liste mit IDs und Informationen der letzten 10 PvP-Spiele (authentifiziert)
    • /v2/pvp/seasons - API noch nicht aktiv
    • /v2/pvp/stats - eine Liste mit allgemeinen PvP-Statistiken (authentifiziert)

Verschiedenes[Bearbeiten]

  • /v2/build - die aktuelle Build-ID (Programmversion)
  • /v2/colors - eine Liste der im Spiel verfügbaren Farben
  • /v2/currencies - eine Liste mit IDs der verfügbaren Währungen und Details dazu
  • /v2/files - allgemeine Icons zur Verwendung mit dem Render-Service
  • /v2/quaggans - liefert eine Liste von Bezeichnern von Quaggan-Bildern für verschiedene Zwecke
  • /v2/skills - eine Liste mit IDs und Informationen der verfügbaren Hilfsfertigkeiten
  • /v2/specializations - eine Liste mit IDs und Informationen der verfügbaren Spezialisierungen
  • /v2/tokeninfo - Liste der durch den API-Schlüssel verfügbaren Berechtigungen (authentifiziert)
  • /v2/traits - eine Liste mit IDs und Informationen der verfügbaren Eigenschaften
  • /v2/leaderboards - API noch nicht aktiv

Version 1[Bearbeiten]

Die Version 1 der API bietet folgende Endpunkte:

Welt- und Karteninformation[Bearbeiten]

Die folgenden Endpunkte liefern Informationen, welche in Verbindung mit dynamischen Events, Welt gegen Welt oder dem Kachel-Service genutzt werden können:

Dynamische Events[Bearbeiten]

Gegenstände[Bearbeiten]

Welt gegen Welt[Bearbeiten]

Verschiedenes[Bearbeiten]

Zusätzliche Ressourcen[Bearbeiten]

Kachel-Service[Bearbeiten]

Seit dem 21.6.2013 stellt ArenaNet einen Kachel-Service für Karten zur Verfügung, der die Möglichkeit bietet, mit gängigen Bibliotheken wie z.B. der Google-Maps-API oder leaflet.js eine Karte der Spielwelt zu projizieren (einfaches Beispiel). Das verwendete Kachel-Format ist in der Dokumentation der Google-Maps-API beschrieben. Auf die einzelnen Kacheln kann mittels einer URL nach folgendem Schema zugegriffen werden:

 https://tiles.guildwars2.com/{continent_id}/{floor}/{zoom}/{x}/{y}.jpg 

Gültige Werte für continent_id und floor können über continents.json ermittelt werden. map_floor.json bietet wertvolle Informationen über Kartenbegrenzungen und sichtbare Bereiche, die dem Endbenutzer dargestellt werden sollten. Der Service bietet momentan keine Informationen über Untergründe, etwa wie wenn ein Charakter eine Höhle betritt.

Schriftarten[Bearbeiten]

Zusätzlich zum Kachel-Service wurden zwei Stylesheets zur direkten Einbindung bereitgestellt, um Kartenbeschriftungen in der korrekten Schriftart "Menomonia" darzustellen:

https://d1h9a8s8eodvjz.cloudfront.net/fonts/menomonia/08-02-12/menomonia.css
https://d1h9a8s8eodvjz.cloudfront.net/fonts/menomonia/08-02-12/menomonia-italic.css

Icon-Render-Service[Bearbeiten]

Seit dem 6.8.2013 stellt ArenaNet einen Render-Service für Icons zur Verfügung, auf welchen nach folgendem Schema zugegriffen werden kann:

 https://render.guildwars2.com/file/{signature}/{file_id}.{format} 

Die Parameter signature und file_id werden hierbei von verschiedenen APIs (momentan nur items und files) bereitgestellt und die Icons können dann sowohl im .png als auch im .jpg-Format ausgegeben werden.

Siehe auch[Bearbeiten]