ForHosting KIT · Strumenti per sviluppatori

Calcoli il voto ponderato di una rubrica per criteri

Questa calcolatrice combina i punteggi percentuali dei singoli criteri con i pesi esatti stabiliti dalla rubrica di valutazione.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Controlla la validità di ogni punteggio e peso, rifiuta il calcolo quando i pesi non totalizzano 100% e restituisce sia il risultato ponderato sia un voto convenzionale da A a F. Mostra inoltre il contributo di ciascun criterio, così Lei può verificare il risultato, spiegarlo allo studente o inserirlo in un flusso di valutazione senza dipendere dalle formule di un foglio elettronico.

Prepari punteggi e pesi dei criteri

Inserisca un record per ogni criterio della rubrica. Ogni record richiede un nome chiaro, un punteggio percentuale compreso tra 0 e 100 e un peso percentuale compreso tra 0 e 100. Per esempio, un criterio di ricerca valutato 92 e pari al 30% del compito deve avere punteggio 92 e peso 30. Prima dell'invio, converta in percentuale i criteri basati su punti: 18 punti ottenuti su 20 possibili corrispondono a 90. Mantenga nell'input tutte le righe della rubrica, comprese quelle a peso zero che rimangono utili per il riscontro ma non devono incidere sul voto. Nel risultato, i nomi compaiono accanto ai valori originali e ai rispettivi contributi ponderati; etichette precise e stabili facilitano quindi ogni controllo successivo. La calcolatrice accetta fino a 100 criteri e respinge nomi vuoti, valori non numerici, infiniti e numeri fuori dall'intervallo consentito, senza tentare di indovinare l'intenzione di chi ha definito la valutazione.

Comprenda il calcolo ponderato

Per ogni criterio, la calcolatrice moltiplica il punteggio percentuale per il relativo peso e divide per 100. Un punteggio di 80 in un criterio che vale il 25% contribuisce quindi con 20 punti ponderati. Tutti i contributi vengono poi sommati per ottenere il totale. Prima di restituire il risultato, lo strumento verifica che i pesi inseriti totalizzino 100%. Il controllo è importante perché una serie incompleta può produrre comunque un numero credibile, ma sottostimare o sovrastimare il voto effettivo. Sono tollerate minime differenze dovute alla rappresentazione informatica dei decimali; un totale realmente insufficiente o eccessivo genera invece un errore di input e i pesi non vengono mai normalizzati in modo invisibile. Contributi e totale sono arrotondati a due decimali. La scala fissa assegna A da 90, B da 80, C da 70, D da 60 e F sotto 60. Verifichi sempre che queste soglie coincidano con il regolamento adottato.

Utilizzi e controlli il risultato

La risposta fornisce il punteggio totale, il voto in lettere, il totale dei pesi confermato e l'elenco ordinato dei criteri con ciascun contributo ponderato. Questo dettaglio è utile ben oltre il voto finale. Un docente può mostrare in che modo le diverse dimensioni hanno inciso sull'esito, un sistema didattico può archiviare il calcolo insieme alla valutazione originale e una persona incaricata della revisione può riprodurre il totale senza ricostruire formule. Poiché l'algoritmo è deterministico e non usa servizi di rete, lo stesso input valido produce sempre lo stesso risultato JSON nel browser e tramite API. Consideri il voto alfabetico una comodità basata sulle soglie A–F dichiarate, non un sostituto della politica dell'istituto. Se il corso adotta più e meno, regole promosso o respinto, curve, criteri esclusi o arrotondamenti speciali, applichi tali disposizioni separatamente. In caso di errore nei pesi, corregga la rubrica o aggiunga i criteri mancanti anziché modificare i punteggi per forzare il totale a 100.

Casi d'uso

Concludere la valutazione di un elaborato

Combini ricerca, analisi, accuratezza e presentazione secondo la rubrica approvata, conservando il dettaglio dei contributi.

Convalidare un flusso didattico

Respinga dati non validi prima che il punteggio ponderato venga scritto nel registro o nella carriera dello studente.

Spiegare le decisioni di valutazione

Mostri a studenti e revisori in che modo ogni criterio ha contribuito alla percentuale finale e al voto in lettere.

Domande frequenti

Quanto costa una richiesta?

Ogni richiesta API costa $0.002. La calcolatrice funziona anche nel browser per l'utilizzo di livello A.

Cosa accade se i pesi non totalizzano 100%?

La richiesta restituisce un errore di input non valido. La calcolatrice non normalizza silenziosamente pesi incompleti o eccessivi.

Quale scala di voti alfabetici viene usata?

La scala assegna A da 90, B da 80, C da 70, D da 60 e F sotto 60.

Posso usare punti anziché percentuali?

Non direttamente. Prima dell'invio, converta i punti ottenuti in percentuale rispetto al massimo di ogni criterio.

Sono ammessi criteri con peso zero?

Sì. Un criterio con peso zero compare nel dettaglio, ma aggiunge zero punti al totale.

Come viene applicato l'arrotondamento?

Ogni contributo visualizzato e il punteggio finale vengono arrotondati a due decimali. Il voto alfabetico deriva dal totale arrotondato.

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/rubric-score-aggregate

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/rubric-score-aggregate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"criteria":[{"name":"Research","score":92,"weight":30},{"name":"Analysis","score":84,"weight":45},{"name":"Presentation","score":96,"weight":25}]}'

const res = await fetch("https://api.kit.forhosting.com/edu/rubric-score-aggregate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "criteria": [
      {
        "name": "Research",
        "score": 92,
        "weight": 30
      },
      {
        "name": "Analysis",
        "score": 84,
        "weight": 45
      },
      {
        "name": "Presentation",
        "score": 96,
        "weight": 25
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/rubric-score-aggregate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "criteria": [
        {
            "name": "Research",
            "score": 92,
            "weight": 30
        },
        {
            "name": "Analysis",
            "score": 84,
            "weight": 45
        },
        {
            "name": "Presentation",
            "score": 96,
            "weight": 25
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/rubric-score-aggregate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"criteria":[{"name":"Research","score":92,"weight":30},{"name":"Analysis","score":84,"weight":45},{"name":"Presentation","score":96,"weight":25}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"criteria":[{"name":"Research","score":92,"weight":30},{"name":"Analysis","score":84,"weight":45},{"name":"Presentation","score":96,"weight":25}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/rubric-score-aggregate", 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

{
  "criteria": [
    {
      "name": "Research",
      "score": 92,
      "weight": 30
    },
    {
      "name": "Analysis",
      "score": 84,
      "weight": 45
    },
    {
      "name": "Presentation",
      "score": 96,
      "weight": 25
    }
  ]
}

Esempio di risposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.rubric_score_aggregate",
  "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 →