Maintenant période d'offre NOTRE API A ETE EXPLOREE

Nouvelle API V3.0 : Obtenir notre API à prix réduit. Profitez-en dès maintenant. Profitez de résultats de conversion de couleurs plus détaillés - parfaits pour les projets web, les plug-ins, les outils internes ou les applications SaaS. Valable de 2025-10-21 à 2025-11-21 (23:59 CET) inclus.

Paquets API & prix X

V3.0 Nouveau – qConv.com Related Colors - Documentation de l'API

L'API qConv Related Color vous permet d'obtenir des couleurs correspondantes à partir de votre couleur d'origine - y compris RGB, HEX, CMYK, PANTONE®, RAL, HKS, NCS et des palettes de fabricants personnalisées.
Important: Pour les fabricants ou les palettes de couleurs comme RAL, Pantone, etc. la couleur de palette la plus proche est toujours renvoyée.

🔑 Authentification

L'API qConv utilise des clés API que vous pouvez gérer via votre profil.

Auth via un paramètre URL

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

Remarque: La clé est encodée en Base64URL (compatible avec les URL) et est sécurisée.

🔗 Point final

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

📥 Paramètres de la demande

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
apikey string ✅ Oui Votre clé API personnelle et secrète

Formats pris en charge

Formats couleur

rgb hex cmyk pantone ral hks ncs sw

Couleurs du fabricant

Tous les codes de fabricants que vous trouverez sur les pages des fabricants sous le lien suivant sont des valeurs valables.

https://qconv.com/fr/entreprises

Sur les pages des fabricants, recherchez dans la colonne de gauche la mention du code API ou ce symbole:

✅ Exemple de demande

Hex

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

Réponse :

{
    "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 %"
    }
}

Couleur du fabricant BEHR

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

Réponse :

{
    "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 %"
    }
}

📦 Structure de réponse

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
related object Le champ related contient les teintes associées qui sont calculées à partir de la couleur transmise. En font partie les couleurs complémentaires, les variantes plus claires et plus foncées ainsi que les harmonies de couleurs comme la triade ou la tétrade. Pour plus d'informations : Related en détail.
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.

Related en détail

Type de couleur Type Description
comp object La couleur complémentaire, c'est-à-dire la couleur opposée sur le cercle chromatique.
dark array Un dégradé de jusqu'à cinq variantes plus foncées de la couleur initiale.
light array Un dégradé de jusqu'à cinq variantes plus claires de la couleur.
ana array Jusqu'à cinq nuances de couleurs qui sont directement voisines sur le cercle chromatique.
mono array Jusqu'à cinq variations monochromes de la même couleur de base avec des luminosités ou des saturations différentes.
warm array Jusqu'à cinq variantes plus chaudes de la couleur - des tons légèrement décalés vers le rouge ou le jaune.
cold array Jusqu'à cinq variantes plus froides de la couleur - des tons qui tirent davantage vers le bleu ou le violet.
sat_more array Jusqu'à cinq couleurs avec une saturation accrue des couleurs (effet plus fort et plus intense).
sat_less array Jusqu'à cinq couleurs avec une saturation réduite (effet plus atténué, plus discret).
split array Trois couleurs du schéma de complémentarité scindé - deux tons qui se trouvent à côté de la couleur complémentaire.
triad array Schéma de couleurs triadique - trois couleurs réparties uniformément sur le cercle chromatique.
tetrad array Schéma de couleurs tétraédrique - quatre couleurs formant un rectangle sur le cercle chromatique.
square array

Chaque objet contient les valeurs suivantes

Valeurs des couleurs Type Description
mfg string / null Nom du fabricant de peinture, si disponible (par ex. Behr, OBI, RAL).
name string / null Désignation officielle des couleurs du fabricant, si disponible.
rgb string Valeurs RGB, séparées par un espace (par exemple '113 184 151').
hex string Code couleur hexadécimal (par exemple, '#71B897').
cmyk string Représentation CMYK (pourcentages pour les applications d'impression ou de design).
hsl string Teinte, saturation et luminosité (Hue, Saturation, Lightness).
lab string Valeurs dans l'espace colorimétrique CIELAB, adaptées à des comparaisons de couleurs précises et à l'analyse des couleurs.

⚠️ Codes d'erreur

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" => "v3.0",
    "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" => "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 %"
    }
}

📈 Limites de l'API & facturation

Chaque clé API a une limite mensuelle. 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" => "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 %"
    }
}

🛠️ Gestionnaire d'API

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

🔒 Sécurité

Tous les paramètres sont envoyés par GET.

Limitation du taux par clé en option

Clés Base64URL de 32 octets de long

🧼 Conseils aux développeurs

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

185C et 185 C fonctionnent pour PANTONE

Support

Remarque: Pour des raisons techniques, il se peut 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 non mentionnée, contactez-nous à info[at]qconv.com. Nous offrons un support aux clients à partir du 'service API de base'.

🆕 Protocole de changement

API-V3.0:

  • NOUVEAU: Il est possible d'obtenir, pour les couleurs transmises, les couleurs correspondantes telles que complémentaire, plus clair, plus foncé, plus chaud, plus froid, etc. Pour cela, nous avons créé le fichier /api/color.php.
  • LAB et HSL couleur intégrée dans la réponse
  • Dans l'objet user_data, nous avons unifié l'identifiant 'used tokens' en le soulignant.
    NOUVEAU : 'used_tokens'.
  • Dans l'objet user_data, nous avons uniformisé l'identifiant 'max tokens' en le soulignant.
    NOUVEAU : 'max_tokens'.
  • Dans l'objet user_data, nous avons uniformisé l'identifiant 'percentage used' en le soulignant.
    NOUVEAU : 'percentage_used'.

2025-10-21

API-V2.0:

  • Les différences de couleur sont désormais affichées en tant que valeur de différence de couleur au format dE00 (Delta E 2000) lors de la conversion vers le fabricant.
  • S'il y a une désignation de couleur (Sherwin Williams, NCS (allemand), HEX ou RGB), celle-ci est affichée.
  • Le numéro de version de l'API et l'horodatage sont également indiqués.
  • En cas d'erreur de saisie, le motif est expliqué de manière plus détaillée.

2025-08-14

API-V1.0:

  • API intégrée dans le site web

2025-07-15

Pour pouvoir enregistrer les palettes de couleurs, une inscription est nécessaire.

Se connecter à votre compte

ou

Créer un compte

Partager la palette de couleurs actuelle
Doit-elle être publique ou privée?
Les liens suivent après le partage.

Annuler Partager

Palette de couleurs partagée
Veuillez copier et enregistrer le lien souhaité.

Partager

OK, j'ai copié les liens

Vos couleurs sont enregistrées dans une nouvelle palette de couleurs.
Vous pouvez la consulter sous votre profil.
Vous pouvez la personnaliser davantage, et la partager.

Afficher la palette de couleurs
Fermer

Créer une palette de couleurs

TéléchargerTélécharger dans différents formats

Tout supprimer

En cliquant sur , vous pouvez créer des palettes et télécharger les nuanciers.