API/v2/tokeninfo

/v2/tokeninfo

HTTP-Methode

GET

Format

JSON

API-Version

Version 2

Berechtigungen

Account

Gibt Informationen über den verwendeten API-Schlüssel zurück.

Parameter

• keine

Antwort

• id (string) - Die ID des API-Schlüssels (entspricht der ersten Hälfte des API-Schlüssels)
• name (string) - Der vom Accountbesitzer festgelegte Name für den API-Schlüssel Achtung: Der Wert dieses Feldes kann gültigen HTML, JavaScript und anderen Code enthalten. Mit Vorsicht behandeln.
• permissions (string-array) - Beschreibt welche Berechtigungen der API-Schlüssel hat. Mögliche Werte:
  • account - Anzeigename des Accounts, ID, Heimatwelt und Gilden-Liste. Erlaut zugriff auf den /v2/account Endpunkt (Diese Berechtigung wird für alle API-Schlüssel benötigt).
  • builds - Aktuell ausgerüstete Spezialisierungen, Eigenschaften, Fertigkeiten und Ausrüstung für alle Spielmodi. Erlaut zugriff auf den /v2/characters/:id/specializations Endpunkt.
  • characters - Grundlegende Informationen über Charaktere. Erlaut zugriff auf den /v2/characters Endpunkt und untergeordnete.
  • guilds - Mitgliederlisten der Gilden, Verlauf und Nachrichten des Tages für alle Gilden, bei denen du Mitglied bist. Erlaut zugriff auf den /v2/guilds/:id Endpunkt und untergeordnete. (Zugriff derzeit nur für Gildenleiter)
  • inventories - Account-Bank, Materialienlager, Rezept-Freischaltungen und Charakter-Inventare.Erlaut zugriff auf /v2/account/bank, /v2/account/inventory, /v2/account/materials, /v2/characters/:id/equipment, /v2/characters/:id/inventory und /v2/characters/:id/recipes.
  • progression - Erfolge, der Freischaltungsstatus von Verliesen, Aufträge für Beherrschungs-Punkte und allgemeiner PvE-Fortschritt. Erlaut zugriff auf den /v2/account/achievements Endpunkt.
  • pvp - PvP-Werte, Match-Verlauf, die Entwicklung des Belohnungspfades und angepasste Arena-Informationen. Erlaut zugriff auf den /v2/pvp Endpunkt und untergeordnete.
  • tradingpost - Transaktionen beim Handelsposten. Erlaut zugriff auf den /v2/commerce/transactions Endpunkt.
  • unlocks - Garderoben-Freischaltungen – Skins, Farben, Mini Tiergefährten, Todesstöße etc. – und aktuell ausgerüstete Skins. Erlaut zugriff auf /v2/account/dyes, /v2/account/mini und /v2/account/skins.
  • wallet - Account-Geldbörse. Erlaut zugriff auf den /v2/account/wallet Endpunkt.

Beispiel

https://api.guildwars2.com/v2/tokeninfo

Der Anfrageheader muss dabei folgenden Wert enthalten: Authorization: Bearer <access token>

{
   "id": "ABCDE02B-8888-FEBA-1234-DE98765C7DEF",
   "name": "Mein API-Schlüssel",
   "permissions": [
     "account",
     "characters",
     "tradingpost",
     "unlocks",
     "build"
   ]
 }