L'API utilise des clés API que tu peux gérer via ton espace client.
GET /api/v2/convert.php?from=hex&input=FF0000&to=ral&apikey=[TON_API-KEY]
Remarque: La clé est encodée en Base64URL (compatible avec les URL) et sûre...
GET https://qconv.com/api/v2/convert.php
| Paramètres | Type | Nécessaire | Description |
|---|---|---|---|
| from | string | ✅ Oui | Format source de la couleur, par ex. rgb, ral ou nom du fabricant comme behr |
| input | string | ✅ Oui | Valeur de saisie, par exemple FF0000 |
| to | string | ✅ Oui | Format cible de la couleur, par ex. hex, cmyk ou nom du fabricant comme Caparol Color |
| apikey | string | ✅ Oui | Ta clé API personnelle et secrète |
rgb
hex
cmyk
pantone
ral
hks
ncs
sw
Tous les codes de fabricants que vous trouverez sur les sites des fabricants en cliquant sur le lien suivant sont également des valeurs valables.
https://qconv.com/fr/entreprises
Cherchez sur les pages des fabricants, dans la colonne de gauche, la mention du code API. Ou le symbole suivant:
GET /api/v2/convert.php?from=hex &input=FF0000 &to=rgb &apikey=[TON_API-KEY]
{
"api_version" => "v2",
"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": "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/v2/convert.php?from=rgb &input=145, 25, 100 &to=behr &apikey=[TON_API-KEY]
{
"api_version" => "v2",
"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"
},
"user_data": {
"username": "USER #12345",
"used tokens": 2,
"max tokens": 50,
"percentage used": "4 %"
}
}
| Champ | Type | Description |
|---|---|---|
| api_version | string | Renvoie la version de l'API actuellement utilisée, par exemple 'v2'. |
| timestamp | string | Horodatage de la demande au format ISO 8601, par exemple '2025-08-14T13:42:00+01:00'. |
| http_response_code | string | Code d'état HTTP de la réponse (par ex. 200, 400, 500). Indique si la requête a abouti ou si elle a renvoyé une erreur |
| from | string | Format de sortie transmis |
| input | string | Valeur d'origine transmise |
| to | string | Format cible transmis |
| result | string | Le résultat converti |
| name | string/null | Désignation des couleurs pour Sherwin Williams, NCS (allemand), HEX (si disponible), RGB (si disponible) |
| deltaE00 | string/null | Différente entre les couleurs comme valeur DeltaE2000 (ΔE₀₀). Tu trouveras plus d'explications sur Delta E 2000 ou dE₀₀ dans le tableau ci-dessous. |
| match_percent | string/null | Remarque sur la correspondance des couleurs lors de la recherche de la couleur du fabricant appropriée en pourcentage. PAR EX : 'match_percent' : '92.2%', Envoyé uniquement lors de la conversion en couleurs fabricant. |
| more_conversions | object | Toutes les autres conversions parallèles disponibles sous forme de tableau |
| user_data | object | des informations sur leur compte API, comme le nombre de conversions utilisées. |
| error | string | Si une erreur se produit : objet avec d'autres indications comme le code d'erreur, la description, etc. Si la demande est réussie, ce champ est nul ou inexistant. |
| ΔE₀₀ | Description | Perceptibilité par l'homme |
|---|---|---|
| < 0.5 | Imperceptiblement | La différence de couleur n'est pas visible à l'œil nu. |
| 0.5 – 1.0 | Très faible écart | La différence de couleur n'est perceptible que dans des conditions de laboratoire. |
| 1.0 – 2.0 | Faible écart | La différence de couleur est à peine visible, généralement acceptable. |
| 2.0 – 3.0 | Ecart perceptible | La différence de couleur est visible par comparaison directe. |
| 3.0 – 5.0 | Ecart significatif | La différence de couleur est bien visible, éventuellement problématique. |
| > 5.0 | Forte déviation | Différents comme deux couleurs différentes. |
| Tu trouveras d'autres indications sur ΔE₀₀, Delta E 2000 ou dE₀₀ ici: DELTA E 2000 WIKI | ||
| Code d'état | Signification |
|---|---|
| 400 | Paramètre manquant ou invalide |
| 401 | Clé API non valide ou manquante |
| 429 | Limite mensuelle de l'API atteinte |
| 500 | Erreur de serveur interne |
En cas d'absence de la clé API ou de saisie d'une clé API erronée :
{
"api_version" => "v2",
"timestamp" => "2025-08-14T13:28:00+01:00",
"http_response_code" => 401,
"error": "Unauthorized",
}
En cas d'absence de saisie ou de saisie d'une valeur non conforme :
{
"api_version" => "v2",
"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 %"
}
}
Chaque clé API a une limite mensuelle fixe. La gratuité est fixée à 50 jetons par mois par API-Key. Il est possible de créer gratuitement jusqu'à deux API-KEYs.
Cela peut être étendu par des upgrades :
Avec le tarif Basic-API on peut créer 5 API-KEYs avec 200 tokens chacun (∑ 1.000 tokens).
Le tarif Premium API permet de créer 10 API-KEYs avec chacun 1.000 jetons (∑ 10.000 jetons).
Le tarif Voyager-API permet de créer 50 API-KEY avec 10.000 jetons (∑ 500.000 jetons).
Si vous avez des exigences particulières, nous pouvons à tout moment élaborer des offres spécifiques à l'utilisateur. N'hésitez pas à nous contacter.
Lorsque la limite est atteinte :
{
"api_version" => "v2",
"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 %"
}
}
Gérer les clés API (ajouter/supprimer)
Voir l'utilisation totale et celle liée à l'API
Augmenter les limites par mois grâce aux mises à niveau
Générer de nouvelles clés (Base64URL-sûr)
Ajouter des commentaires pour mieux les distinguer
Tous les paramètres sont envoyés par GET.
Limitation du taux par clé en option
Clés Base64URL de 32 octets de long
Tous les paramètres sont case-insensitive.
Le code hexadécimal n'est pas possible avec # : seuls FF0000 sont valables
255,0,0 ou 255 0 0 pour RGB
Tous les paramètres sont case-insensitive.
Remarque: Pour des raisons techniques, il peut arriver qu'aucun résultat ne soit affiché pour certains noms de fabricants. Si vous avez besoin d'aide ou si votre conversion ne fonctionne pas pour une autre raison, contactez-nous à info[at]qconv.com. Nous offrons un support aux clients à partir du 'service API de base'.
API-v2:
2025-08-14
API-v1:
2025-07-15