Calculateur de plus-minus basket
Le plus-minus est le chiffre le plus simple et le plus honnête du basket : prenez les points marqués par l'équipe d'un joueur pendant qu'il était sur le terrain, soustrayez les points marqués par l'adversaire pendant le même intervalle, et vous obtenez le plus-minus brut du joueur.
Lancer gratuitement
Un chiffre positif signifie que l'équipe a dominé l'adversaire durant ces minutes ; un chiffre négatif, qu'elle a été dominée. Ce calculateur de plus-minus de basket effectue exactement cette arithmétique en un seul appel déterministe. Vous envoyez les deux totaux de points et vous recevez le différentiel accompagné d'un verdict clair : positif, négatif ou nul. Il fonctionne gratuitement dans votre navigateur sur cette page et coûte $0.002 par requête via l'API.
Ce que le plus-minus mesure vraiment
La feuille de match vous dit ce qu'un joueur a fait : points, rebonds, passes. Le plus-minus pose une autre question : qu'est-il arrivé au tableau d'affichage pendant que ce joueur était sur le terrain ? Si une équipe marque 58 points et en encaisse 51 pendant les vingt-deux minutes d'un meneur, le plus-minus de ce meneur est de +7, qu'il ait marqué deux points ou trente. La métrique, délibérément, crédite et débite le joueur de tout ce qui se passe pendant ses minutes, y compris les actions qui n'apparaissent jamais sur la feuille : un écran qui libère un coéquipier, une rotation précoce qui tue une contre-attaque, ou le simple fait d'écarter le jeu pour que l'attaque respire. Cette ampleur est à la fois la force et la limite connue de la statistique. Un remplaçant qui partage chaque rotation avec une superstar hérite d'une partie de l'impact de cette superstar, et un titulaire coincé dans un mauvais cinq absorbe des dégâts qui ne sont pas les siens. C'est pourquoi les entraîneurs lisent le plus-minus comme un point de départ pour se poser des questions, et non comme un verdict final ; ce calculateur reste fidèle à cet esprit en renvoyant le différentiel brut, sans ajustements cachés.
Comment le calcul fonctionne ici
Le point d'accès accepte deux champs : les points marqués par l'équipe du joueur pendant sa présence sur le terrain, et les points marqués par l'adversaire pendant ce même intervalle. Tous deux doivent être des entiers non négatifs, car un score de basket ne peut pas être négatif et le point fractionnaire n'existe pas. La valeur renvoyée est le premier nombre moins le second, plus un verdict court qui classe le résultat comme positif, négatif ou nul. Les entrées proviennent directement d'une feuille de match ou d'un flux de suivi : la plupart des données action par action étiquettent déjà chaque panier avec les joueurs présents, de sorte que les totaux sur le terrain de n'importe quel joueur sont un simple filtrage suivi d'une somme. Comme l'arithmétique est fixe et déterministe, les deux mêmes entrées produisent toujours la même sortie, dans le widget du navigateur comme dans l'API payante : le résultat web gratuit est, octet par octet, celui pour lequel l'API facture $0.002. Si l'une des valeurs est négative ou n'est pas un nombre entier, la requête est rejetée avec une erreur d'entrée invalide claire et n'est pas facturée.
Lire et utiliser le chiffre avec discernement
Le plus-minus d'un seul match est bruité. Le temps poubelle d'une correction, les changements adverses et les séries de tirs réussis font bouger le chiffre dans tous les sens ; les analystes l'agrégent donc sur de nombreux matchs avant de conclure, ou passent à des variantes ajustées qui tiennent compte des coéquipiers et des adversaires. Pourtant, le différentiel brut a de vrais usages quotidiens. Un entraîneur peut comparer l'évolution du score selon les combinaisons de joueurs pendant un match serré. Un recruteur peut vérifier si la feuille discrète d'un joueur de rôle cachait un fort impact sur le terrain. Un documentaliste de télévision peut obtenir un chiffre rapide pour le sujet d'après-match sans ouvrir un tableur. Et un développeur qui construit un tableau de bord statistique peut appeler ce point d'accès comme une brique petite et testable, au lieu de réécrire la validation à chaque fois. La bonne habitude consiste à accompagner le différentiel de contexte : les minutes jouées, le rythme du match et la qualité des cinq concernés. Cet outil vous donne le chiffre proprement et rapidement ; l'interprétation reste là où elle doit être, chez l'humain qui le lit.
Cas d’usage
Analyse des cinq après le match
Le staff technique saisit les points marqués et encaissés par joueur depuis le relevé action par action et obtient le plus-minus de chacun en quelques secondes.
Widget pour un tableau de bord
Un développeur ajoute une colonne plus-minus au tableau analytique de l'équipe en appelant le point d'accès par joueur, en réutilisant sa validation au lieu d'écrire la sienne.
Recherche pour la diffusion
Un documentaliste TV calcule un différentiel rapide pour le sujet de la mi-temps sans se battre avec un tableur en plein direct.
Questions fréquentes
Combien cela coûte-t-il ?
$0.002 par requête via l'API. Il est également gratuit de l'exécuter dans votre navigateur sur cette page, avec des résultats identiques.
De quelles données a-t-il besoin ?
De deux nombres : les points marqués par votre équipe pendant que le joueur était sur le terrain, et ceux marqués par l'adversaire sur le même intervalle. Tous deux doivent être des entiers non négatifs.
Que se passe-t-il si j'envoie une valeur négative ?
La requête est rejetée avec une erreur d'entrée invalide indiquant quel champ est en cause. Les requêtes rejetées ne sont pas facturées.
Est-ce la même chose que le plus-minus ajusté ?
Non. Il s'agit du plus-minus brut : points de l'équipe moins points de l'adversaire pendant les minutes du joueur. Les variantes ajustées, qui neutralisent coéquipiers et adversaires, relèvent d'un calcul séparé et bien plus lourd.
Puis-je envoyer les valeurs sous forme de texte ?
Oui. Les chaînes de nombres entiers comme « 58 » sont acceptées et interprétées. Les décimales, les valeurs négatives et le texte non numérique sont rejetés.
Pour les développeurs — accès API
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.
Endpoint
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é.
Appeler depuis votre stack
curl -X POST https://api.kit.forhosting.com/sports/plus-minus-calculate \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"team_points":58,"opponent_points":51}'const res = await fetch("https://api.kit.forhosting.com/sports/plus-minus-calculate", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"team_points": 58,
"opponent_points": 51
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/sports/plus-minus-calculate",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"team_points": 58,
"opponent_points": 51
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/sports/plus-minus-calculate", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"team_points":58,"opponent_points":51}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"team_points":58,"opponent_points":51}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/sports/plus-minus-calculate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemple de requête
{
"team_points": 58,
"opponent_points": 51
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "sports.plus_minus_calculate",
"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.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |