ForHosting KIT · Strumenti per sviluppatori

Voto ponderato su totale

I programmi di corso raramente usano un unico percentuale grezzo. Mischiano compiti, laboratori, prove intermedie e finali —ciascuno con il proprio massimo e il proprio peso— e lo studente ha ancora bisogno di un solo numero sulla scala pubblicata: un voto su venti, un punteggio su dieci o un risultato combinato su cento.

● BetaGratis · nel tuo browser

Esegui gratis nel browser Vedi l'API

Usalo da WebAPIEmailTelegramApp presto

Questo calcolatore trasforma quell’insieme ponderato di punteggi per categoria in un unico voto sul totale che Lei sceglie. Inserisca ogni categoria con i punti ottenuti, i punti possibili e il peso, poi imposti out_of (ad esempio 20 per un classico voto su 20). Il motore normalizza ogni riga in un rapporto, ne fa la media ponderata, moltiplica per il Suo totale e restituisce mark, mark_display e il dettaglio per categoria. La stessa aritmetica pura alimenta il widget gratuito del browser e il percorso API, così pianificatori di studio, aiuti LMS e demo di classe non divergono mai sul risultato scalato.

Come si usa

Inserisci i dati nel modulo qui sopra. Lo strumento li controlla prima del calcolo e mostra il risultato nella stessa pagina.

Controlla i dati

Segui le etichette e le unità indicate per ogni campo. Se manca qualcosa o un valore non è ammesso, la pagina indica cosa correggere.

Ripeti il calcolo o automatizzalo

Usa lo strumento web per controlli singoli e l’API quando vuoi integrare la stessa capacità in un flusso automatizzato.

Casi d'uso

Ottieni subito una risposta

Inserisci una serie di valori e visualizza il risultato senza preparare un foglio di calcolo o uno script.

Confronta gli scenari

Modifica un valore alla volta e ripeti il calcolo per capire cosa cambia il risultato.

Automatizza le attività ripetute

Usa l’API quando lo stesso calcolo deve essere eseguito nel tuo prodotto o flusso.

Domande frequenti

Come si usa questa capacità?

Compila i campi qui sopra ed eseguila in questa pagina. Il modulo segnala i dati da correggere.

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/weighted-score-out-of

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/weighted-score-out-of \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"categories":[{"label":"Homework","score":85,"max_score":100,"weight":30},{"label":"Midterm","score":16,"max_score":20,"weight":30},{"label":"Final","score":42,"max_score":50,"weight":40}],"out_of":20}'

const res = await fetch("https://api.kit.forhosting.com/edu/weighted-score-out-of", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "categories": [
      {
        "label": "Homework",
        "score": 85,
        "max_score": 100,
        "weight": 30
      },
      {
        "label": "Midterm",
        "score": 16,
        "max_score": 20,
        "weight": 30
      },
      {
        "label": "Final",
        "score": 42,
        "max_score": 50,
        "weight": 40
      }
    ],
    "out_of": 20
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/weighted-score-out-of",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "categories": [
        {
            "label": "Homework",
            "score": 85,
            "max_score": 100,
            "weight": 30
        },
        {
            "label": "Midterm",
            "score": 16,
            "max_score": 20,
            "weight": 30
        },
        {
            "label": "Final",
            "score": 42,
            "max_score": 50,
            "weight": 40
        }
    ],
    "out_of": 20
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/weighted-score-out-of", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"categories":[{"label":"Homework","score":85,"max_score":100,"weight":30},{"label":"Midterm","score":16,"max_score":20,"weight":30},{"label":"Final","score":42,"max_score":50,"weight":40}],"out_of":20}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"categories":[{"label":"Homework","score":85,"max_score":100,"weight":30},{"label":"Midterm","score":16,"max_score":20,"weight":30},{"label":"Final","score":42,"max_score":50,"weight":40}],"out_of":20}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/weighted-score-out-of", 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

{
  "categories": [
    {
      "label": "Homework",
      "score": 85,
      "max_score": 100,
      "weight": 30
    },
    {
      "label": "Midterm",
      "score": 16,
      "max_score": 20,
      "weight": 30
    },
    {
      "label": "Final",
      "score": 42,
      "max_score": 50,
      "weight": 40
    }
  ],
  "out_of": 20
}

Esempio di risposta

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