ForHosting KIT · Strumenti per sviluppatori

Punti persi per raggiungere il voto desiderato

Questo calcolatore trasforma il sistema a punti di un corso in un margine chiaro.

● BetaGratis · nel tuo browser

Usalo da WebAPIEmailTelegramApp presto

Inserisca i punti totali del corso, quelli disponibili finora, quelli ottenuti e la percentuale desiderata. Scoprirà quanti punti ha già perso, la perdita massima compatibile con l’obiettivo e quanti altri punti può ancora lasciare. Lo strumento indica inoltre i punti e la percentuale necessari nelle attività rimanenti, così Lei può verificare se il traguardo è ancora raggiungibile senza affidarsi soltanto alla media attuale.

Consideri il voto desiderato come un budget di punti

Un obiettivo percentuale diventa molto più semplice da valutare quando viene convertito in punti. Immagini un corso con 500 punti complessivi e un obiettivo del 90 per cento. Servono quindi 450 punti, il che significa che nell’intero corso se ne possono perdere al massimo 50. Quei 50 punti costituiscono il budget totale di perdita. Se finora erano disponibili 320 punti e Lei ne ha ottenuti 285, ne ha persi 35. Rimane dunque un margine di 15 punti. Il calcolatore esegue direttamente queste conversioni e tiene distinti i valori: i punti persi finora descrivono le attività già valutate, mentre gli ulteriori punti che si possono perdere indicano il margine prima che l’obiettivo diventi irraggiungibile. La distinzione è importante, perché la percentuale corrente può apparire rassicurante quando le prove più semplici sono già concluse, oppure preoccupante quando restano ancora molti punti. Utilizzi, se possibile, il totale ufficiale del corso. Se il programma cambia, aggiorni insieme il totale e i punti disponibili fino a quel momento, affinché il risultato continui a rappresentare lo stesso sistema di valutazione.

Inserisca valori cumulativi dello stesso ambito di valutazione

Tutti e quattro i dati devono riferirsi allo stesso corso, periodo, modulo o altro ambito di valutazione. I punti totali comprendono ogni punto che sarà disponibile al termine di tale ambito. I punti possibili finora sono la somma dei valori massimi delle attività già valutate, non i punti che Lei ha scelto di tentare. I punti ottenuti sono la somma corrispondente delle valutazioni assegnate. Il calcolatore rifiuta combinazioni impossibili, per esempio punti ottenuti superiori a quelli possibili oppure punti già valutati superiori al totale del corso. La percentuale obiettivo deve essere compresa tra 0 e 100. I punti extra richiedono attenzione: se il docente consente di superare il massimo nominale, questo modello non considera il bonus come punteggio ordinario. Inserisca i bonus conteggiati ufficialmente sia nel relativo totale possibile sia nel totale del corso, oppure calcoli prima il sistema normale e valuti a parte la regola del bonus. Non combini percentuali di categorie ponderate con punti grezzi. Per un corso ponderato, converta ogni categoria nel contributo ufficiale oppure utilizzi un calcolatore specifico per medie ponderate.

Interpreti realisticamente il risultato richiesto nelle prove rimanenti

Il risultato comprende i punti ancora disponibili, quelli da ottenere tra i rimanenti e la percentuale minima necessaria. Questi valori rispondono a una domanda diversa dal budget di perdita, ma insieme offrono un controllo utile. Se il margine residuo è zero, ogni ulteriore punto perso porterà il voto finale sotto l’obiettivo. Se target_still_possible è falso, nemmeno ottenere tutti i punti rimasti consentirebbe di raggiungere la percentuale richiesta; il calcolatore mostra quindi zero punti aggiuntivi perdibili e indica quanti punti servirebbero, rendendo evidente lo scarto. Quando non resta alcuna attività, la percentuale richiesta è zero se l’obiettivo è già raggiunto e 100 in caso contrario, perché non esistono altre prove nelle quali recuperare punti. Consideri il calcolo uno strumento di pianificazione, non una previsione. Penalità per ritardi, prove escluse, curve, limiti per categoria, regole di arrotondamento e bonus inattesi possono modificare il voto ufficiale. Ripeta il calcolo dopo ogni valutazione e confronti il risultato con le regole pubblicate dal docente prima di stabilire le Sue priorità di studio.

Casi d'uso

Pianificare il resto del corso

Verifichi il margine esatto disponibile prima che la percentuale finale desiderata diventi irraggiungibile.

Valutare il recupero dopo un voto basso

Misuri come una prova insufficiente ha modificato il margine e quale risultato servirà nelle attività successive.

Confrontare obiettivi di voto realistici

Provi diverse percentuali per distinguere un traguardo agevole da uno che richiede risultati quasi perfetti.

Domande frequenti

Che cosa significano i punti persi?

Sono la differenza tra i punti possibili nelle attività valutate e quelli ottenuti nelle stesse attività.

Come vengono calcolati gli altri punti che si possono perdere?

Il calcolatore sottrae i punti già persi dalla perdita totale massima consentita dal voto obiettivo e riporta a zero un eventuale risultato negativo.

Posso usarlo per un corso con ponderazioni?

Solo dopo aver convertito ogni categoria in un contributo uniforme al totale del corso. Non combini direttamente punti appartenenti a categorie con pesi diversi.

Perché l’obiettivo viene indicato come impossibile?

È impossibile quando i punti già ottenuti, sommati a tutti quelli ancora disponibili, non raggiungono il totale richiesto dalla percentuale desiderata.

Il calcolatore gestisce punti extra o curve?

Il modello usa un sistema a punti fisso. Applichi prima ai totali la regola ufficiale su bonus o curve, oppure consideri separatamente tale modifica.

Quanto costa una richiesta API?

Ogni richiesta API costa $0.002. Lo stesso calcolo deterministico può essere eseguito gratuitamente anche nel browser.

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/points-lost-to-grade

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/points-lost-to-grade \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"total_points":500,"points_possible_so_far":320,"points_earned_so_far":285,"target_percent":90}'

const res = await fetch("https://api.kit.forhosting.com/edu/points-lost-to-grade", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "total_points": 500,
    "points_possible_so_far": 320,
    "points_earned_so_far": 285,
    "target_percent": 90
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/points-lost-to-grade",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "total_points": 500,
    "points_possible_so_far": 320,
    "points_earned_so_far": 285,
    "target_percent": 90
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/points-lost-to-grade", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"total_points":500,"points_possible_so_far":320,"points_earned_so_far":285,"target_percent":90}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"total_points":500,"points_possible_so_far":320,"points_earned_so_far":285,"target_percent":90}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/points-lost-to-grade", 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

{
  "total_points": 500,
  "points_possible_so_far": 320,
  "points_earned_so_far": 285,
  "target_percent": 90
}

Esempio di risposta

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