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

V1.0 – qConv.com Converter - API–Dokumentation

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

🔑 Authentifizierung

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

Auth via URL-Parameter

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

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

🔗 Endpunkt

GET https://qconv.com/api/v1/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 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 zu rgb

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

Antwort:

    {
        "from": "hex",
        "input": "FF0000",
        "to": "rgb",
        "result": "255 0 0",
        "more_conversions": {
            "pantone": "185",
            "ral": "3026",
            "hks": "10",
            "rgb": "255 0 0",
            "hex": "#FF0000",
            "cmyk": "0 100 100 0",
            "sw": "2910",
            "ncs": "S1085-Y90R"
        },
        "user_data": {
            "username": "USER #12345",
            "used tokens": 1,
            "max tokens": 50,
            "percentage used": "2 %"
        }
    }

rgb zu Herstellerfarbe BEHR

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

Antwort:

    {
        "from": "rgb",
        "input": "145, 25, 100",
        "to": "behr",
        "result": "p120-7 glitterati",
        "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"
        },
        "user_data": {
            "username": "USER #12345",
            "used tokens": 2,
            "max tokens": 50,
            "percentage used": "4 %"
        }
    }

📦 Antwortstruktur

Feld Typ Beschreibung
from string Übermitteltes Ausgangsformat
input string Übermittelter Originalwert
to string Übermitteltes Zielformat
result string Das Konvertierte Ergebnis
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.

⚠️ Fehlercodes

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

📈 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:

{
        "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'.

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