API/v2/achievements

Aus Guild Wars 2 Wiki
< API‎ | v2
Zur Navigation springen Zur Suche springen
/v2/achievements
HTTP-Methode
GET
Format
JSON
API-Version
Version 2


Gibt Detailinformationen zu Erfolgen zurück.

Parameter[Bearbeiten]

Antwort[Bearbeiten]

Wenn der Endpunkt ohne Parameter abgefragt wird (/v2/achievements), wird eine Liste aller verfügbaren Erfolgs-IDs zurückgegeben. Wenn mehrere Erfolge mit dem Parameter ids angefordert werden, wird ein Array mit mehreren Objekten entsprechend der Anfrage zurückgegeben. Für jeden Erfolg wird ein Objekt mit den folgenden Eigenschaften zurückgegeben.

  • id - ID des Erfolgs
  • icon (string, optional) – URL des Icons
  • name (string) – lokalisierter Name
  • description (string) – lokalisierte Beschreibung (Kommentar)
  • requirement (string) – lokalisierte allgemine Anforderung
  • locked_text (string) – lokalisierte Anforderung zur Freischaltung des Erfolgs
  • type (string) – Typ des Erfolgs. Mögliche Werte
  • flags (string-array) - Mögliche Werte
    • Pvp - Fortschrit nur im PvP oder WvW
    • CategoryDisplay - Meta-Erfolg
    • MoveToTop - beeinflusst in-game UI verhalten
    • IgnoreNearlyComplete - wird nicht unter "Fast abgeschlossen" im UI angezeigt
    • Repeatable - wiederholbarer Erfolg
    • RequiresUnlock - freischaltung des Erfolgs durch einen Gegenstand/Skin oder den Abschluss einer bestimmt Aktion; Nicht bei Freischaltung durch einen anderen Erfolg
  • prerequisites (number-array, optional) - IDs der zur Freischaltung benötigten Erfolge
  • tiers (object-array) - Beschreibt die Erfolgsränge. Jedes Objekt enthällt:
    • count (number) - Anzahl der für den Rang zu erreichende Dinge
    • points (number) - Anzahl der Erfoglspunkte für den Abschluss des Rangs
  • rewards (object-array, optional) - Beschreibt die Belohnungen für das Abschließen des Erfolgs. Jedes Objekt enthällt:
    • type (string) - Typ der Belohnung. Weiter Felder sind abhängig vom Wert von type.
      • Wenn Item:
        • id (number) - ID des Gegenstandes der erhalten wird
        • count (number) - Menge des Gegenstandes
      • Wenn Mastery:
        • region (string) - Die Region, zu der, der Beherrschungspunkt gehört. Entweder Tyria oder Maguuma.
        • id (string) - ID des Beherrschungspunktes der erhalten wird
      • Wenn Coins:
        • count (number) - Anzahl der erhaltenen Münzen in Kupfer
      • Wenn Title:
        • id (number) - ID des Titels der erhalten wird
  • bits (object-array, optional) - Eine Sammlung von Objekten mit weiteren Details zu den Anforderungen des Erfolgs.
    • type (string) - Typ des Bits. Kann sein: Text, Item, Minipet, oder Skin.
    • id (number, optional) - Die ID des Items, Minis, oder Skins.
    • text (string, optional) - Der Text des Bits, falls type gleich Text ist.
  • point_cap (number, optional) - Die maximale Anzahl an Erfolgspunkten für wiederholbare Erfolge.

Beispiel[Bearbeiten]

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

[
  1,
  2,
  3,
  4,
  5,
  6,
  7,
  8,
  ...
]

https://api.guildwars2.com/v2/achievements?ids=1840,910,2258&lang=de

[
    {
        "id": 910,
        "name": "Tequatl der Sonnenlose",
        "description": "",
        "requirement": "Schließt  Tequatl-Erfolge ab.",
        "locked_text": "",
        "type": "Default",
        "flags": [
            "CategoryDisplay"
        ],
        "tiers": [
            {
                "count": 10,
                "points": 50
            }
        ],
        "rewards": [
            {
                "type": "Mastery",
                "region": "Tyria",
                "id": 247
            },
            {
                "type": "Title",
                "id": 175
            }
        ]
    },
    {
        "id": 1840,
        "name": "Täglicher Komplettierer",
        "description": "",
        "requirement": "Schließt  beliebige tägliche Erfolge im PvE, WvW oder PvP ab.",
        "locked_text": "",
        "type": "Default",
        "flags": [
            "Pvp",
            "CategoryDisplay"
        ],
        "tiers": [
            {
                "count": 3,
                "points": 10
            }
        ],
        "rewards": [
            {
                "type": "Item",
                "id": 70047,
                "count": 1
            },
            {
                "type": "Coins",
                "count": 20000
            }
        ]
    },
    {
        "id": 2258,
        "name": "Nebelwächter-Beinschützer",
        "description": "",
        "requirement": "Sammelt alle  Gegenstände und Skins, um Eure Nebelwächter-Beinschützer zu schmieden.",
        "locked_text": "Schließt die Widergänger-Spezialisierung \"Beschwörung\" ab, um die Nebelwächter-Beinschützer-Sammlung freizuschalten.",
        "type": "ItemSet",
        "flags": [
            "IgnoreNearlyComplete",
            "Pvp",
            "RepairOnLogin",
            "RequiresUnlock"
        ],
        "bits": [
            {
                "type": "Skin",
                "id": 208
            },
            {
                "type": "Skin",
                "id": 197
            },
            ...
            {
                "type": "Item",
                "id": 74774
            }
        ],
        "tiers": [
            {
                "count": 1,
                "points": 1
            },
            {
                "count": 3,
                "points": 1
            },
            {
                "count": 7,
                "points": 1
            }
        ],
        "rewards": [
            {
                "type": "Item",
                "id": 70598,
                "count": 1
            }
        ]
    }
]