Jetzt Angebotszeitraum UNSERE API WURDE ERWEITERT

Neue API V3.0: Unsere API zum Angebotspreis erhalten. Greifen Sie jetzt zu. Nutzen Sie detailiertere 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 Converter - API–Dokumentation

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

Mit der qConv Converter API kannst du Farben zwischen verschiedenen Formaten konvertieren – einschließlich RGB, HEX, CMYK, PANTONE®, RAL, HKS, NCS und benutzerdefinierten Herstellerpaletten.

🔑 Authentifizierung

Die API verwendet API-Keys, die du über deinen Kundenbereich verwalten kannst.

Auth via URL-Parameter

GET /api/v3.0/convert.php?from=hex&input=FF0000&to=ral&apikey=[DEIN_API-KEY]

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

🔗 Endpunkt

GET https://qconv.com/api/v3.0/convert.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
to string ✅ Ja Zielformat der Farbe, z. B. hex, cmyk oder Herstellernamen wie Caparol Color
apikey string ✅ Ja Dein persönlicher und geheimer API-Key

Unterstützte Formate

Farbformate

rgb hex cmyk pantone ral hks ncs sw

+ Herstellerfarben

Alle Hersteller-Codes die sie unter den Herstellerseiten unter dem folgenden link finden, sind ebenfalls 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 dem folgenden Symbol:

✅ Beispielanfrage

Hex zu rgb

GET /api/v3.0/convert.php?from=hex&input=FF0000&to=rgb&apikey=[DEIN_API-KEY]

Antwort:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "hex",
    "input": "ffa500",
    "to": "rgb",
    "result": "255 165 0",
    "name": "Orange",
    "more_conversions": {
        "pantone": "137",
        "ral":     "1028",
        "hks":     "5",
        "rgb":     "255 165 0",
        "hex":     "#FFA500",
        "cmyk":    "0 35 100 0",
        "sw":      "6905",
        "ncs":     "S0580-Y30R",
        "hsl":     "38.82 1 0.5",
        "lab":     "74.93 23.94 78.96"
    },
    "user_data": {
        "username": "USER #12345",
        "used tokens": 1,
        "max tokens": 50,
        "percentage used": "2 %"
    }
}

rgb zu Herstellerfarbe BEHR

GET /api/v3.0/convert.php?from=rgb&input=145, 25, 100&to=behr&apikey=[DEIN_API-KEY]

Antwort:

{
    "api_version" => "v3.0",
    "timestamp" => "2025-08-14T13:28:00+01:00",
    "http_response_code" => 200,
    "from": "rgb",
    "input": "145, 25, 100",
    "to": "behr",
    "result": "p120-7 glitterati",
    "deltaE00": "11.2"
    "match_percent": "93.1%",
    "more_conversions": {
        "pantone": "7649",
        "ral": "4006",
        "hks": "28",
        "rgb": "145 25 100",
        "hex": "#911964",
        "cmyk": "0 83 31 43",
        "sw": "6842",
        "ncs": "S3055-R30B",
        "hsl": "322.5 0.71 0.33",
        "lab": "33.21 53.97 -13.06"
    },
    "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
to string Übermitteltes Zielformat
result string Das Konvertierte Ergebnis
name string/null Farbbezeichnung für Sherwin Williams, NCS (deutsch), HEX (falls vorhanden), RGB (falls vorhanden)
deltaE00 string/null Unterschiedlich zwischen den Farben als DeltaE2000-Wert (ΔE₀₀). Weitere Erklärungen zu Delta E 2000 oder dE₀₀ findest du in der untenstehenden Tabelle.
match_percent string/null Hinweis zur Farbübereinstimmung bei der Suche nach der passenden Herstellerfarbe in Prozent. Z. B.: 'match_percent': '92.2%',
Wird nur bei Konvertierung zu Herstellerfarben ausgegeben.
more_conversions object Alle weiteren verfügbaren Parallelkonvertierungen als Array
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

ΔE₀₀ und die Bedeutung der Werte

ΔE₀₀ Beschreibung Wahrnehmbarkeit durch den Menschen
< 0.5 Unmerklich Der Farbunterschied ist für das menschliche Auge nicht sichtbar.
0.5 – 1.0 Sehr geringe Abweichung Der Farbunterschied ist nur unter Laborbedingungen wahrnehmbar.
1.0 – 2.0 Geringe Abweichung Der Farbunterschied ist kaum sichtbar, in der Regel akzeptabel.
2.0 – 3.0 Wahrnehmbare Abweichung Der Farbunterschied ist sichtbar bei direktem Vergleich.
3.0 – 5.0 Deutliche Abweichung Der Farbunterschied ist gut erkennbar, evtl. problematisch.
> 5.0 Starke Abweichung Unterschiedlich wie zwei verschiedene Farben.
Weitere Hinweise zu ΔE₀₀, Delta E 2000 oder dE₀₀ findest du hier: DELTA E 2000 WIKI

⚠️ 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, from or to" | "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 festes 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 keinen Ergebnis ausgegeben wird. Falls sie Hilfe benötigen oder ihre Konvertierung aus einem anderen 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 Information zurückgegeben

2025-08-14

API-V1.0:

  • API in die Website integriert

2025-07-15

Um Farbpaletten speichern zu können, musst Du angemeldet sein.

Bei deinem Konto anmelden

oder

Erstelle ein Konto

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

Abbrechen Teilen

Farbpalette geteilt
Bitte kopiere und speichere dir den gewünschten Link.

Teilen

OK, ich habe die Links kopiert

Deine Farben werden in einer neuen Farbpalette gespeichert.
Sehe sie dir unter deinem Profil an.
Du kannst sie weiter anpassen, und teilen.

Farbpalette anzeigen
Schließen

Erstelle eine Farbpalette

HerunterladenHerunterladen in verschiedenen Formaten

Alle Entfernen

Durch Klicken auf kannst du Paletten erstellen und die Farbfelder herunterladen.

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