Die API verwendet API-Keys, die du über deinen Kundenbereich verwalten kannst.
GET /api/v1/convert.php?from=hex&input=FF0000&to=ral&apikey=[DEIN_API-KEY]
Hinweis: Der Key ist Base64URL-encodiert (URL-kompatibel) und sicher..
GET https://qconv.com/api/v1/convert.php
| 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 |
rgb
hex
cmyk
pantone
ral
hks
ncs
sw
Alle Hersteller-Codes die sie unter den Herstellerseiten unter dem folgenden link finden, sind ebenfalls gültige Werte.
https://qconv.com/en/hersteller
Suchen sie auf den Herstellerseiten in der linken Spalte nach dem Hinweis zu API-Code. Oder nach dem folgenden Symbol:
GET /api/v1/convert.php?from=hex &input=FF0000 &to=rgb &apikey=[DEIN_API-KEY]
{
"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 %"
}
}
GET /api/v1/convert.php?from=rgb &input=145, 25, 100 &to=behr &apikey=[DEIN_API-KEY]
{
"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 %"
}
}
| 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. |
| Statuscode | Bedeutung |
|---|---|
| 400 | Fehlender oder ungültiger Parameter |
| 401 | Ungültiger oder fehlender API-Key |
| 429 | Monatliches API-Limit erreicht |
| 500 | Interner Serverfehler |
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:
{
"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-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
Alle Parameter werden per GET gesendet
Rate-Limiting pro Key optional
32 Byte lange Base64URL-Schlüssel
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
Alle Parameter sind case-insensitive
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'.