ForHosting KIT · Outils pour développeurs

Échelle de couleurs par classes

L’outil d’échelle de couleurs par classes affecte une valeur numérique à l’un de plusieurs intervalles de même largeur et renvoie la couleur correspondante entre deux extrémités hexadécimales.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Indiquez la valeur, un minimum et un maximum inclusifs, le nombre de classes ainsi que les couleurs initiale et finale. Chaque entrée est validée, la borne supérieure est traitée explicitement et le résultat reste toujours identique. Utilisez cet outil pour les tableaux de bord, cartes, niveaux de score, légendes, rapports et traitements exigeant une classification reproductible plutôt qu’un dégradé continu.

Transformez une plage continue en catégories fiables

Un dégradé continu peut suggérer une précision supérieure à celle de la mesure. Les classes rendent la décision explicite : toutes les valeurs d’un même intervalle reçoivent exactement la même couleur. Saisissez la valeur numérique, les bornes inférieure et supérieure inclusives et le nombre de classes souhaité. L’outil divise la plage en intervalles de même largeur, les numérote à partir de un et fournit leur indice à partir de zéro ainsi que leurs limites numériques. Chaque intervalle comprend sa borne inférieure et exclut sa borne supérieure, sauf le dernier qui comprend le maximum déclaré. Cette règle évite que deux systèmes classent différemment une valeur placée exactement sur une limite. L’indicateur renvoyé précise également si la borne supérieure est inclusive. Ce fonctionnement convient lorsqu’un graphique, un export, un service et une vue web doivent appliquer la même classification. L’outil n’analyse aucun jeu de données et ne calcule pas de quantiles statistiques : le minimum et le maximum fournis définissent entièrement l’échelle, indépendamment d’observations cachées ou de leur ordre.

Construisez l’échelle par interpolation RGB déterministe

La première classe utilise la couleur initiale et la dernière la couleur finale. Les couleurs intermédiaires sont obtenues en interpolant séparément les canaux rouge, vert et bleu, puis en arrondissant chaque canal à l’entier le plus proche. La position dépend de l’indice de classe et non de la valeur brute : deux valeurs appartenant au même intervalle reçoivent donc la même couleur hexadécimale. Les extrémités acceptent six chiffres hexadécimaux avec ou sans croisillon, et la sortie est normalisée en minuscules avec ce signe. L’interpolation RGB est volontairement simple et reproductible dans l’API comme dans le navigateur. Ce n’est pas un espace colorimétrique perceptuel ; pour une palette soumise à des exigences d’accessibilité, choisissez des extrémités dont les teintes intermédiaires restent distinctes et suffisamment contrastées. Le résultat contient la couleur, l’indice, le numéro lisible, le total des classes et les limites numériques. Vous pouvez ainsi produire simultanément marque colorée, infobulle, légende, validation ou trace d’audit sans reproduire ailleurs le calcul des bornes.

Validez les plages avant toute visualisation

Un écrêtage silencieux paraît pratique jusqu’à ce qu’une erreur en amont affiche une valeur impossible comme valide. L’outil refuse donc les nombres non finis, les plages inversées ou nulles, les valeurs hors limites inclusives, les couleurs mal formées et les nombres de classes autres que des entiers compris entre 2 et 256. Les erreurs deviennent exploitables et le tableau de bord ne masque pas de mauvaises mesures. Définissez les limites dans le système propriétaire de la métrique, puis réutilisez-les pour toutes les valeurs. Si la distribution est très asymétrique et exige de véritables quantiles de populations égales, calculez d’abord leurs seuils ; cette fonction crée des classes de même largeur entre des extrémités explicites. Pour une légende stable, appliquez les mêmes règles aux libellés et aux observations. Le maximum fait l’objet d’un traitement spécial afin qu’une division flottante ne le place pas après le dernier indice. Les autres limites exactes entrent dans la classe suivante selon la convention documentée. Le navigateur et l’API payante partagent le même algorithme pur : vous pouvez donc prévisualiser le résultat avant de l’automatiser pour $0.002 par requête.

Colorer un tableau de performance

Attribuez des couleurs cohérentes aux valeurs de latence, revenus, utilisation ou qualité dans les cartes et graphiques.

Créer une classification choroplèthe

Répartissez les mesures régionales en intervalles fixes et conservez la concordance entre remplissages et légende.

Normaliser les niveaux de risque

Appliquez une plage, un nombre de classes et une palette communs aux scores répétés des rapports et exports.

Cet outil calcule-t-il les quantiles statistiques d’un jeu de données ?

Non. Il crée des classes de même largeur entre le minimum et le maximum explicites, sans recevoir ni analyser de jeu de données.

Que se passe-t-il si la valeur égale le maximum ?

Le maximum est valide et appartient à la dernière classe, dont la borne supérieure est inclusive.

Quels formats de couleur sont acceptés ?

Utilisez une couleur RGB hexadécimale à six chiffres, avec ou sans croisillon. La sortie est en minuscules et comprend ce signe.

Comment les couleurs intermédiaires sont-elles calculées ?

Les canaux rouge, vert et bleu sont interpolés séparément selon la position de la classe, puis arrondis à des entiers.

Les valeurs hors plage peuvent-elles être écrêtées ?

Non. Elles sont refusées afin qu’une mesure invalide ne soit pas silencieusement présentée comme une couleur extrême valide.

Quel est le tarif ?

L’API coûte $0.002 par requête. Le même calcul déterministe s’exécute gratuitement dans le navigateur.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/color/scale-buckets

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/color/scale-buckets \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"value":72,"min":0,"max":100,"buckets":5,"start_color":"#ffffcc","end_color":"#800026"}'
{
  "value": 72,
  "min": 0,
  "max": 100,
  "buckets": 5,
  "start_color": "#ffffcc",
  "end_color": "#800026"
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.scale_buckets",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →