API/v2/colors

/v2/colors

HTTP-Methode

GET

Format

JSON

API-Version

Version 2

Gibt Informationen über die im Spiel implementierten Farben zurück. Die Umrechnung der HSL-Farbcodes nach RGB hat ArenaNet-Programmierer Cliff Spradlin anhand eines Beispiels gezeigt.

Parameter

• allgemeine Anfrageparameter

Antwort

Wenn der Endpunkt ohne Parameter abgefragt wird (/v2/colors), wird eine Liste aller verfügbaren Farben-IDs zurückgegeben. Wenn mehrere Farben mit dem Parameter ids angefordert werden, wird ein Array mit mehreren Objekten entsprechend der Anfrage zurückgegeben. Für jede Farbe wird ein Objekt zurückgegeben, welches folgende Eigenschaften besitzt:

• id (number) – die ID der Farbe
• name (string) – der Name der Farbe
• base_rgb (list) – die RGB-Basiswerte
• cloth (object) – Detailinformationen über das Aussehen auf Rüstungsteilen aus Stoff
• leather (object) – Detailinformationen über das Aussehen auf Rüstungsteilen aus Leder
• metal (object) – Detailinformationen über das Aussehen auf Rüstungsteilen aus Metall

Die Objekte mit den Detailinformationen besitzen folgende Eigenschaften:

• brightness (number) – Helligkeit
• contrast (number) – Kontrast
• hue (number) – der Farbton im HSL-Farbraum
• saturation (number) – die Farbsättigung im HSL-Farbraum
• lightness (number) – die Helligkeit im HSL-Farbraum
• rgb (array) – ein Array mit vorberechneten Werten im RGB-Farbraum

Beispiel

https://api.guildwars2.com/v2/colors/126?lang=de

{
    "id": 126,
    "name": "Echt scharfes Pink",
    "base_rgb": [128, 26, 26],
    "cloth": {
        "brightness": 14,
        "contrast": 1.21094,
        "hue": 340,
        "saturation": 0.820313,
        "lightness": 1.44531,
        "rgb":[169, 54, 94]
    },
    "leather": {
        "brightness": 14,
        "contrast": 1.21094,
        "hue": 340,
        "saturation": 0.703125,
        "lightness": 1.44531,
        "rgb": [160, 62, 96]
    },
    "metal": {
        "brightness": 14,
        "contrast": 1.21094,
        "hue": 340,
        "saturation": 0.585938,
        "lightness": 1.44531,
        "rgb": [151, 69, 98]
    }
}