ForHosting KIT · Utilidades de desarrollo

Nota ponderada sobre total

Los temarios rara vez usan un único porcentaje bruto. Mezclan deberes, laboratorios, parciales y finales —cada uno con su máximo y su peso— y el estudiante sigue necesitando un solo número en la escala publicada: una nota sobre veinte, una marca sobre diez o un resultado combinado sobre cien.

● BetaGratis · en su navegador

Ejecutar — gratis Cómo funciona y API

Úselo desde WebAPIEmailTelegramApp pronto

Esta calculadora convierte ese conjunto ponderado de puntuaciones por categoría en una sola marca sobre el total que usted elija. Introduzca cada categoría con los puntos obtenidos, los posibles y el peso, y fije out_of (por ejemplo 20 para una nota clásica sobre 20). El motor normaliza cada fila a un cociente, promedia esos cocientes por peso, multiplica por su total y devuelve mark, mark_display y el desglose por categoría. La misma aritmética pura alimenta el widget gratuito del navegador y la ruta API, de modo que planificadores de estudio, ayudas LMS y demos de aula no discrepen sobre el resultado escalado.

Cómo usarla

Ingrese sus datos en el formulario de arriba. La herramienta los revisa antes de calcular y muestra el resultado en la misma página.

Revise sus datos

Use las etiquetas y unidades indicadas en cada campo. Si falta algo o un valor está fuera del rango permitido, la página señala qué debe corregir.

Repita el cálculo o automatícelo

Use la herramienta web para comprobaciones individuales y la API cuando necesite integrar la misma capacidad en un flujo automatizado.

Qué puede hacer con ella

Obtenga una respuesta ahora

Ingrese un conjunto de valores y vea el resultado sin preparar una hoja de cálculo ni un script.

Compare escenarios

Cambie un valor a la vez y repita el cálculo para entender qué modifica el resultado.

Automatice el trabajo repetido

Use la API cuando necesite ejecutar el mismo cálculo dentro de su producto o flujo.

Preguntas frecuentes

¿Cómo uso esta capacidad?

Complete los campos de arriba y ejecútela en esta página. El formulario señala cualquier dato que deba corregir.

Para desarrolladores — acceso por API

Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.

Endpoint de API

POSThttps://api.kit.forhosting.com/edu/weighted-score-out-of

¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.

Llámela desde su 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)

Ejemplo de solicitud

{
  "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
}

Ejemplo de respuesta

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

La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.

Precio

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

Errores

HTTP	Código	Significado
`401`	`unauthorized`	API key ausente o inválida.
`402`	`insufficient_balance`	El saldo no cubre el precio de la tarea.
`404`	`unknown_type`	El tipo de tarea no existe.
`429`	`rate_limited`	Demasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →