ForHosting KIT · Outils pour développeurs

Calculateur d’étendue

Le calculateur d’étendue mesure tout l’écart entre la plus petite et la plus grande valeur d’un jeu de données numérique.

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

Fournissez un tableau non vide et obtenez l’effectif, le minimum, le maximum et l’étendue, calculée comme maximum moins minimum. L’opération est déterministe, conserve les nombres négatifs et décimaux et refuse les tableaux vides ou les valeurs non finies. Utilisez-la comme statistique descriptive rapide, règle de validation ou composant d’un traitement reproductible.

Ce que l’étendue révèle sur vos données

L’étendue compte parmi les mesures les plus simples de dispersion statistique. Elle répond à une question directe : quelle distance sépare la plus petite et la plus grande observation ? Le calculateur examine chaque nombre fourni, détermine le minimum et le maximum, puis soustrait le premier du second. Pour les valeurs 4, 7, 12, 15 et 19, le minimum vaut 4, le maximum 19 et l’étendue 15. Un jeu ne contenant qu’une valeur a une étendue nulle, car son minimum et son maximum sont identiques. Les nombres négatifs ne demandent aucun traitement particulier : si le minimum vaut -8 et le maximum 3, l’étendue vaut 11. Le résultat reste toujours positif ou nul pour une entrée finie valide. Cette statistique donne rapidement une idée de l’échelle, mais ne décrit que les deux extrémités. Elle ne montre ni la répartition des valeurs intermédiaires, ni leur éventuelle concentration, ni l’influence d’une observation extrême. Associez-la à la médiane, aux quartiles ou à l’écart-type lorsque la distribution interne compte.

Préparez et validez le tableau numérique

Envoyez les observations dans le champ numbers sous forme de tableau JSON comprenant au moins un nombre fini. Les entiers, décimaux, zéros et valeurs négatives sont acceptés, et leur ordre initial ne change pas la réponse. Les chaînes ressemblant à des nombres sont volontairement invalides : la valeur JSON "12" est du texte, tandis que 12 est un nombre. Convertissez les cellules importées d’un tableur ou les champs de formulaire avant l’envoi afin qu’une étiquette accidentelle, une chaîne vide, une valeur nulle ou une mesure mal formée ne modifie pas silencieusement le calcul. Les valeurs infinies et NaN sont également refusées, car elles ne peuvent pas produire un résultat JSON fini et portable. Après validation, la réponse contient l’effectif, le minimum, le maximum et l’étendue, ce qui facilite l’audit. Si le tableau est vide ou comporte un élément non numérique, la requête renvoie une erreur d’entrée invalide plutôt qu’une statistique partielle trompeuse.

Exploitez le résultat dans vos analyses et automatisations

L’étendue constitue une mesure de contrôle compacte. Un processus qualité peut comparer l’étendue de mesures répétées à une tolérance autorisée et signaler un lot trop dispersé. Une application qui surveille les temps de réponse peut suivre chaque jour la différence entre ses observations les plus rapides et les plus lentes. Les enseignants et les étudiants peuvent vérifier des exercices de statistique tout en consultant les extrémités à l’origine de la réponse. Dans un flux d’API, conservez le minimum, le maximum, l’étendue et l’effectif avec le lot source afin que les contrôleurs puissent reproduire la conclusion. Gardez à l’esprit que l’étendue est très sensible aux valeurs aberrantes : une seule lecture erronée peut dominer la statistique même si toutes les autres sont stables. Si cette sensibilité ne convient pas, examinez les données et ajoutez une mesure fondée sur les quartiles. Le calculateur parcourt le tableau une fois, sans réseau, hasard ni horloge. Chaque requête API coûte $0.002 et respecte les mêmes règles que la version du navigateur.

Contrôlez la dispersion des mesures

Comparez l’écart entre les mesures minimale et maximale à une tolérance de contrôle qualité autorisée.

Résumez une série de scores

Présentez l’intervalle observé dans des évaluations, enquêtes ou concours avec ses extrémités.

Validez des données importées

Refusez les tableaux numériques vides ou contaminés avant qu’un traitement en utilise l’étendue.

Comment l’étendue des données est-elle calculée ?

La plus petite valeur est soustraite de la plus grande : étendue = maximum - minimum.

Le tableau peut-il contenir des nombres négatifs ou décimaux ?

Oui. Tout nombre JSON fini est accepté, notamment les valeurs négatives, le zéro, les entiers et les décimaux.

Que se passe-t-il si le tableau est vide ?

La capacité renvoie une erreur d’entrée invalide, car aucun minimum ni maximum ne peut être défini pour un jeu vide.

Les chaînes numériques sont-elles acceptées ?

Non. Les valeurs comme "12" sont du texte et sont refusées ; envoyez plutôt 12 comme nombre JSON.

Combien coûte une requête API ?

Chaque requête API coûte $0.002. Le même calcul déterministe peut aussi être exécuté 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/stat/data-range

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/stat/data-range \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"numbers":[12,7,19,4,15]}'
{
  "numbers": [
    12,
    7,
    19,
    4,
    15
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "stat.data_range",
  "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 →