L'API utilise des clés API que tu peux gérer via ton espace client.
GET /api/v1/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/v1/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/en/entreprises
Cherchez sur les pages des fabricants, dans la colonne de gauche, la mention du code API. Ou le symbole suivant:
GET /api/v1/convert.php?from=hex &input=FF0000 &to=rgb &apikey=[TON_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=[TON_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 %"
}
}
| Champ | Type | Description |
|---|---|---|
| from | string | Format de sortie transmis |
| input | string | Valeur d'origine transmise |
| to | string | Format cible transmis |
| result | string | Le résultat converti |
| 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. |
| 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 |
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 :
{
"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'.