Jetzt Angebotszeitraum UNSERE API WURDE ERWEITERT

Neue API V3.0: Unsere API zum Angebotspreis erhalten. Greifen Sie jetzt zu. Nutzen Sie detailliertere Farbkonvertierungsergebnisse – perfekt für Webprojekte, Plugins, interne Tools oder SaaS-Anwendungen. Gültig vom 2025-10-21 bis einschließlich 2025-11-21 (23:59 CET)

API-Pakete & Preise X
API-V1.0 API-V2.0 API-V3.0 Neu
< Zum API-Manager

Inhalt

🔑 Authentifizierung

Auth via URL-Parameter

🔗 Endpunkt

📥Anfrageparameter

Unterstützte Formate

✅ Beispielanfrage

📦 Antwortstruktur

⚠️ Fehlercodes

📈 API-Limits & Abrechnung

🛠️ API-Manager

🔒 Sicherheit

🧼 Hinweise für Entwickler

🆕 Änderungsprotokoll

V3.0 Neu – qConv.com Related Colors - API–Dokumentation

Convert-API V3.0 Color-API V3.0 Neu

Mit der qConv Related Color API können Sie passende Farben von Ihrer Ursprungsfarbe erhalten – einschließlich RGB, HEX, CMYK, PANTONE®, RAL, HKS, NCS und benutzerdefinierten Herstellerpaletten.
WICHTIG: Bei Herstellern oder Farbpaletten wie RAL, Pantone usw. wird immer die nächst passende Palettenfarbe zurückgegeben.

🔑 Authentifizierung

Die qConv-API verwendet API-Keys, die Sie über Ihr Profil verwalten können.

Auth via URL-Parameter

GET /api/v3.0/color.php?from=hex&input=FF0000&apikey=[IHR_API-KEY]

Hinweis: Der Key ist Base64URL-encodiert (URL-kompatibel) und sicher.

🔗 Endpunkt

GET https://qconv.com/api/v3.0/color.php

📥 Anfrageparameter

Parameter Typ Erforderlich Beschreibung
from string ✅ Ja Quellformat der Farbe, z. B. rgb, ral oder Herstellernamen wie behr
input string ✅ Ja Eingabewert, z. B. FF0000
apikey string ✅ Ja Ihr persönlicher und geheimer API-Key

Unterstützte Formate

Farbformate

rgb hex cmyk pantone ral hks ncs sw

Herstellerfarben

Alle Hersteller-Codes die Sie auf den Herstellerseiten unter dem folgenden link finden, sind gültige Werte.

https://qconv.com/de/hersteller

Suchen Sie auf den Herstellerseiten in der linken Spalte nach dem Hinweis zu API-Code oder nach diesem Symbol:

✅ Beispielanfrage

Hex

GET /api/v3.0/color.php?from=hex&input=FF0000&apikey=[IHR_API-KEY]

Antwort:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "hex",
    "input": "ffa500",
    "related": {
        "comp": {
            "rgb": "0 255 255",
            "hex": "#00FFFF",
            "cmyk": "100 0 0 0",
            "hsl": "180 1 0.5",
            "lab": "91.12 -48.08 -14.14"
        },
        "dark": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "light": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "ana": [
            {
                "rgb": "255 0 136",
                "hex": "#FF0088",
                "cmyk": "0 100 47 0",
                "hsl": "328 1 0.5",
                "lab": "55.11 85.15 -0.4"
            },
            {...},
            {...}
        ],
        "mono": [
            {
                "rgb": "172 0 0",
                "hex": "#AC0000",
                "cmyk": "0 100 100 33",
                "hsl": "0 1 0.34",
                "lab": "35.54 59.64 49.89"
            },
            {...},
            {...}
        ],
        "warm": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "cold": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "sat_more": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            }
        ],
        "sat_less": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "split": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "triad": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "tetrad": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ],
        "square": [
            {
                "rgb": "255 0 0",
                "hex": "#FF0000",
                "cmyk": "0 100 100 0",
                "hsl": "0 1 0.5",
                "lab": "53.23 80.11 67.22"
            },
            {...},
            {...}
        ]
    },
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 1,
        "max_tokens": 50,
        "percentage_used": "2 %"
    }
}

Herstellerfarbe BEHR

GET /api/v3.0/color.php?from=behr&input=p120-7 glitterati&apikey=[IHR_API-KEY]

Antwort:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "behr",
    "input": "p120-7 glitterati",
    "related": {
        "comp": {
            "manufacturer": "Behr",
            "name": "mq6-41 farmer´s market",
            "rgb": "113 184 151",
            "hex": "#71B897",
            "cmyk": "39 0 18 28",
            "hsl": "152.11 0.33 0.58",
            "lab": "69.49 -29.81 9.81"
        },
        "dark": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "light": [
            {
                "mfg": "Behr",
                "name": "ppu1-16 haitian flower",
                "rgb": "151 73 90",
                "hex": "#97495A",
                "cmyk": "0 52 40 41",
                "hsl": "346.92 0.35 0.44",
                "lab": "41.35 34.47 5.42"
            },
            {...},
            {...}
        ],
        "ana": [
            {
                "mfg": "Behr",
                "name": "p110-7 xoxo",
                "rgb": "145 80 123",
                "hex": "#91507B",
                "cmyk": "0 45 15 43",
                "hsl": "320.31 0.29 0.44",
                "lab": "43.04 33.27 -12.51"
            },
            {...},
            {...}
        ],
        "mono": [
            {
                "mfg": "Behr",
                "name": "bxc-21 chicory root",
                "rgb": "95 66 63",
                "hex": "#5F423F",
                "cmyk": "0 31 34 63",
                "hsl": "5.63 0.2 0.31",
                "lab": "31.09 12.12 6.83"
            },
            {...},
            {...}
        ],
        "warm": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "cold": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "sat_more": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "sat_less": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "split": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "triad": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "tetrad": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ],
        "square": [
            {
                "mfg": "Behr",
                "name": "p120-7 glitterati",
                "rgb": "148 74 99",
                "hex": "#944A63",
                "cmyk": "0 50 33 42",
                "hsl": "339.73 0.33 0.44",
                "lab": "41.37 33.97 -0.2"
            },
            {...},
            {...}
        ]
    },
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 2,
        "max_tokens": 50,
        "percentage_used": "4 %"
    }
}

📦 Antwortstruktur

Feld Typ Beschreibung
api_version string Gibt die aktuell verwendete Version der API zurück, z. B. 'v2'
timestamp string Zeitstempel der Anfrage im ISO 8601-Format, z. B. '2025-08-14T13:42:00+01:00'
http_response_code string HTTP-Statuscode der Antwort (z. B. 200, 400, 500). Gibt an, ob die Anfrage erfolgreich war oder einen Fehler zurückgegeben hat
from string Übermitteltes Ausgangsformat
input string Übermittelter Originalwert
related object Das Feld related enthält die zugehörigen Farbtöne, die aus der übergebenen Farbe berechnet werden. Dazu gehören Komplementärfarben, hellere und dunklere Varianten sowie Farbharmonien wie Triade oder Tetrade. Für mehr Infos: Related im Detail.
user_data object Informationen zum Ihrem API-Konto wie z. B. die Anzahl der genutzten Konvertierungen.
error string Falls ein Fehler auftritt: Objekt mit weiteren Angaben wie Fehlercode, Beschreibung etc. Bei erfolgreicher Anfrage ist dieses Feld null oder nicht vorhanden

Related im Detail

Farbart Typ Beschreibung
comp object Die komplementäre Farbe, also die gegenüberliegende Farbe auf dem Farbkreis.
dark array Eine Abstufung von bis zu fünf dunklerer Varianten der Ausgangsfarbe.
light array Eine Abstufung von bis zu fünf hellerer Varianten der Farbe.
ana array Bis zu fünf Farbnuancen, die auf dem Farbkreis in direkter Nachbarschaft liegen.
mono array Bis zu fünf Monochrome Variationen derselben Grundfarbe mit unterschiedlichen Helligkeiten oder Sättigungen.
warm array Bis zu fünf Wärmere Varianten der Farbe – Töne, die leicht in Richtung Rot oder Gelb verschoben sind.
cold array Bis zu fünf Kältere Varianten der Farbe – Töne, die mehr ins Bläuliche oder Violette gehen.
sat_more array Bis zu fünf Farben mit erhöhter Farbsättigung (kräftigere, intensivere Wirkung).
sat_less array Bis zu fünf Farben mit verringerter Sättigung (gedämpftere, zurückhaltendere Wirkung).
split array Drei Farben aus dem gespaltenen Komplementärschema – zwei Töne, die neben der Komplementärfarbe liegen.
triad array Triadisches Farbschema – drei gleichmäßig auf dem Farbkreis verteilte Farben.
tetrad array Tetradisches Farbschema – vier Farben, die ein Rechteck auf dem Farbkreis bilden.
square array Quadratisches Farbschema – vier Farben mit gleichem Abstand auf dem Farbkreis.

Jedes Object beinhaltet die folgenden Werte

Farbwerte Typ Beschreibung
mfg string / null Name des Farbherstellers, sofern verfügbar (z. B. Behr, OBI, RAL).
name string / null Offizielle Farbbezeichnung des Herstellers, sofern verfügbar.
rgb string RGB-Werte, durch Leerzeichen getrennt (z. B. '113 184 151').
hex string Hexadezimaler Farbcode (z. B. '#71B897').
cmyk string CMYK-Darstellung (Prozentwerte für Druck- oder Design-Anwendungen).
hsl string Farbton, Sättigung und Helligkeit (Hue, Saturation, Lightness).
lab string Werte im CIELAB-Farbraum, geeignet für präzise Farbvergleiche und Farbanalyse.

⚠️ Fehlercodes

Statuscode Bedeutung
400 Fehlender oder ungültiger Parameter
401 Ungültiger oder fehlender API-Key
429 Monatliches API-Limit erreicht
500 Interner Serverfehler

Bei Fehlen des API-Keys oder der Eingabe eines falschen API-Keys:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 401,
    "error": "Unauthorized",

}

Beim Fehlen einer Eingabe oder der Eingabe eines nicht Konformen Wertes:

{
    "api_version" => "v3.0",    
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 400,
    "error": "Missing input or from" | "Conversion failed or input invalid",
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 50,
        "max_tokens": 50,
        "percentage_used": "100 %"
    }
}

📈 API-Limits & Abrechnung

Jeder API-Key hat ein monatliches Limit. Kostenlos sind 50 Tokens pro Monat je API-Key festgelegt. Es können bis zu zwei API-KEYs kostenlos angelegt werden.

Dies kann durch Upgrades erweitert werden:
Mit dem Basic-API Tarif kann man 5 API-KEYs anlegen mit je 200 Tokens (∑ 1.000 Tokens).
Mit dem Premium-API Tarif kann man 10 API-KEYs anlegen mit je 1.000 Tokens (∑ 10.000 Tokens).
Mit dem Voyager-API Tarif kann man 50 API-KEYs anlegen mit je 10.000 Tokens (∑ 500.000 Tokens).
Wenn Sie besondere Anforderungen haben können wir jederzeit auch benutzerspezifische Angebote ausarbeiten. Sprechen Sie uns gerne an.

Bei Erreichen des Limits:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 429,
    "error": "Hello USER #12345, your monthly API quota of 50 requests has been used up. Please contact [email protected] to upgrade or wait for the next reset.",
    "user_data": {
        "username": "USER #12345",
        "used_tokens": 50,
        "max_tokens": 50,
        "percentage_used": "100 %"
    }
}

🛠️ API-Manager

API-Keys verwalten (hinzufügen/löschen)

Gesamte und API-bezogene Nutzung einsehen

Limits pro Monat erhöhen durch Upgrades

Neue Keys generieren (Base64URL-sicher)

Kommentare hinzufügen zur besseren Unterscheidung

🔒 Sicherheit

Alle Parameter werden per GET gesendet

Rate-Limiting pro Key optional

32 Byte lange Base64URL-Schlüssel

🧼 Hinweise für Entwickler

Alle Parameter sind case-insensitive

Hexcode ist nicht mit # möglich: Nur FF0000 sind gültig

255,0,0 oder 255 0 0 bei RGB

185C und 185 C funktionieren für PANTONE

Support

Hinweis: Aus technischen Gründen kann es bei einigen Herstellernamen passieren, dass keine Ergebnisse ausgegeben werden. Falls Sie Hilfe benötigen oder ihre Konvertierung aus einem anderen nicht genannten Grund nicht funktioniert, kontaktieren Sie uns unter info[at]qconv.com. Wir bieten Support für Kunden ab dem 'Basic-API-Service'.

🆕 Änderungsprotokoll

API-V3.0:

  • NEU: Es gibt die Möglichkeit, zu übermittelte Farben die jeweiligen zusammenhängenden Farben wie, Komplementär, Heller, Dunkler, Wärmer, Kälter usw. zu erhalten. Dafür haben wir die /api/color.php erstellt.
  • LAB und HSL Farbe in der Antwort integriert
  • Im object user_data haben wir den Bezeichner 'used tokens' vereinheitlicht mit Unterstrich versehen.
    NEU: 'used_tokens'
  • Im object user_data haben wir den Bezeichner 'max tokens' vereinheitlicht mit Unterstrich versehen.
    NEU: 'max_tokens'
  • Im object user_data haben wir den Bezeichner 'percentage used' vereinheitlicht mit Unterstrich versehen.
    NEU: 'percentage_used'

2025-10-21

API-V2.0:

  • Farbunterschiede werden bei einer Konvertierung zum Hersteller jetzt zusätzlich als Farbunterschiedwert im dE00-Format (Delta E 2000) ausgegeben
  • Wenn es eine Farbbezeichnung gibt (Sherwin Williams, NCS (deutsch), HEX oder RGB) wird diese ausgegeben
  • API-Versionsnummer und Zeitstempel wird mit ausgegeben
  • Bei einer Fehlerhaften Eingabe wird mehr Detailiert über den Grund Informiert

2025-08-14

API-V1.0:

  • API in die Website integriert

2025-07-15

Um Farbpaletten speichern zu können, ist eine Anmelung erforderlich.

Bei Ihrem Konto anmelden

oder

Erstellen Sie ein Konto

Aktuelle Farbpalette teilen
Soll sie öffentlich oder privat sein?
Link(s) folgen nach dem Teilen.

Abbrechen Teilen

Farbpalette geteilt
Bitte kopieren und speichern Sie den gewünschten Link.

Teilen

OK, ich habe die Links kopiert

Ihre Farben werden in einer neuen Farbpalette gespeichert.
Sehen Sie sich diese unter Ihrem Profil an.
Sie können sie weiter anpassen, und teilen.

Farbpalette anzeigen
Schließen

Erstellen Sie eine Farbpalette

HerunterladenHerunterladen in verschiedenen Formaten

Alle Entfernen

Durch Klicken auf können Sie Paletten erstellen und die Farbfelder herunterladen.

© 2019-2025 - Designed by frag-bobby.de