ForHosting KIT · Strumenti per sviluppatori

Calcolatore della curva voti con aumento fisso

Applichi una curva trasparente quando la regola combina un incremento fisso di punti con un minimo garantito.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Inserisca il voto originale, l'aumento, la soglia minima e il voto massimo. Il calcolatore somma l'aumento, confronta il risultato con la soglia, sceglie il valore maggiore e applica il tetto. Indica inoltre quale regola ha determinato il risultato, rendendo semplice spiegarlo, riprodurlo e verificarlo.

Inserisca la regola di valutazione come quattro valori

Parta dal voto grezzo così come appare prima della curva. Inserisca poi l'aumento fisso, cioè lo stesso numero di punti assegnato a ogni voto interessato. La soglia minima è il risultato più basso garantito, mentre il voto massimo è il limite superiore consentito. Tenere distinti questi valori evita di confondere un aumento di cinque punti con una soglia di settanta. Un voto pari a sessanta riceve prima l'aumento; se arriva a sessantacinque, resta sotto la soglia e prevale quest'ultima. Un voto pari a ottanta riceve lo stesso aumento e normalmente resta sopra la soglia. Tutti i dati devono essere numeri finiti e non negativi. Il voto grezzo e la soglia non possono superare il massimo, perché produrrebbero una scala contraddittoria. Sono ammessi decimali quando il corso registra punti frazionari o percentuali.

Segua l'ordine delle operazioni nel risultato

Il calcolo segue una sequenza fissa. Prima somma l'aumento al voto grezzo e mostra il valore intermedio. Poi confronta il voto aumentato con la soglia minima e conserva il maggiore. Infine confronta il valore scelto con il voto massimo e applica il tetto quando serve. In forma compatta, il voto finale è il minimo tra il massimo e il maggiore tra voto aumentato e soglia. La risposta riporta voto finale, aumento totale e regola applicata. minimum_floor indica che l'aumento ordinario non raggiungeva la soglia; flat_bump che l'aumento era sufficiente; maximum_cap che il tetto ha limitato il risultato. L'ordine conta: applicare prima il tetto con una soglia errata potrebbe creare incoerenza, mentre sommare dopo la soglia concederebbe più punti di quelli previsti dalla regola.

Usi il calcolo in modo coerente e ne documenti i limiti

Per una verifica individuale, confronti voto grezzo, valore aumentato e voto finale con la regola scritta del corso. Nei processi in serie, invii una richiesta per voto e conservi la regola applicata insieme al risultato; potrà distinguere chi è stato aiutato dalla soglia da chi ha ricevuto solo l'aumento normale. Input identici producono sempre output identici, senza rete, casualità o ora corrente. Lo strumento non stabilisce se la curva sia equa, autorizzata o conforme alle norme dell'istituto. Non converte lettere, non pondera compiti, non arrotonda secondo regole locali e non modifica registri. Definisca tali decisioni prima dell'uso. Se un'altra politica applica l'aumento solo sotto una soglia, conserva le posizioni relative o ridimensiona l'intera distribuzione, questo modello non è adatto. Lo utilizzi solo quando tutti i voti condividono aumento, minimo e massimo. L'automazione API è disponibile per $0.002 a richiesta.

Casi d'uso

Controllare un voto corretto

Mostri come cambia un punteggio con aumento, soglia garantita e massimo definiti.

Applicare una regola uniforme

Elabori ogni voto con la stessa regola deterministica e conservi quella decisiva.

Verificare le correzioni

Confronti valori grezzo, aumentato e finale per accertare il rispetto dei limiti.

Domande frequenti

Quale formula usa il calcolatore?

Calcola min(maximum_grade, max(raw_grade + bump_amount, minimum_floor)).

L'aumento si somma sopra la soglia minima?

No. Il voto aumentato e la soglia vengono confrontati e si usa il maggiore prima del massimo.

Cosa accade se il voto aumentato supera il massimo?

Il voto finale viene limitato a maximum_grade e la regola applicata è maximum_cap.

Sono ammessi voti decimali?

Sì. Sono accettati numeri finiti e non negativi se voto grezzo e soglia non superano il massimo.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002.

Per sviluppatori — accesso via API

Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.

Endpoint

POSThttps://api.kit.forhosting.com/edu/flat-bump-curve

Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.

Chiamala dal tuo stack

curl -X POST https://api.kit.forhosting.com/edu/flat-bump-curve \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"raw_grade":67,"bump_amount":5,"minimum_floor":75,"maximum_grade":100}'

const res = await fetch("https://api.kit.forhosting.com/edu/flat-bump-curve", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "raw_grade": 67,
    "bump_amount": 5,
    "minimum_floor": 75,
    "maximum_grade": 100
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/flat-bump-curve",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "raw_grade": 67,
    "bump_amount": 5,
    "minimum_floor": 75,
    "maximum_grade": 100
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/flat-bump-curve", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"raw_grade":67,"bump_amount":5,"minimum_floor":75,"maximum_grade":100}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"raw_grade":67,"bump_amount":5,"minimum_floor":75,"maximum_grade":100}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/flat-bump-curve", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Esempio di richiesta

{
  "raw_grade": 67,
  "bump_amount": 5,
  "minimum_floor": 75,
  "maximum_grade": 100
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.flat_bump_curve",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.

Prezzi

per richiesta$0.002

Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.

Errori

HTTP	Codice	Significato
`401`	`unauthorized`	Chiave API mancante o non valida: controlla l'header Authorization.
`402`	`insufficient_balance`	Credito esaurito: ricarica per continuare a eseguire attività.
`404`	`unknown_type`	Tipo di attività sconosciuto: controlla il campo type della richiesta.
`429`	`rate_limited`	Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo.

Leggi la documentazione completa del KIT →