Comprobar nota mínima de examen: porcentaje y margen
El comprobador de nota mínima convierte tres valores brutos en un resultado claro: los puntos obtenidos, el total disponible y la nota mínima para aprobar.
Ejecutar — gratis
Indica si el resultado es apto, convierte la nota y el umbral en porcentajes y muestra la distancia respecto al límite en puntos brutos y puntos porcentuales. Así puede interpretar correctamente cualquier examen, aunque utilice una escala poco habitual.
Introduzca nota y umbral en la misma escala
Use la puntuación bruta obtenida, el máximo posible y la nota mínima, siempre expresados en la misma escala. Si el examen vale 80 puntos, se obtuvieron 58 y se aprueba con 48, introduzca respectivamente 58, 80 y 48. No escriba 60 como umbral solo porque 48 de 80 equivale al 60 por ciento: la herramienta realiza esa conversión. Se admiten decimales para pruebas con crédito parcial. La nota y el mínimo deben estar entre cero y el total, y el total debe ser mayor que cero. Esta disciplina evita comparar por error porcentajes con puntos. El cálculo no deduce ninguna política académica adicional: aplica únicamente el límite que usted proporcione y siempre devuelve el mismo resultado para los mismos datos.
Interprete el resultado, los porcentajes y el margen
El campo passed es verdadero cuando la nota bruta iguala o supera el mínimo. La igualdad aprueba porque el umbral representa la puntuación aceptable más baja. percentage indica qué parte de todos los puntos se consiguió y passing_percentage expresa el mínimo en esa misma escala porcentual. margin_points resta el umbral de la nota: un valor positivo indica puntos por encima, cero señala coincidencia exacta y un valor negativo muestra cuánto faltó. margin_percentage_points expresa la misma diferencia respecto al total del examen. Se habla de puntos porcentuales porque pasar de un umbral del 60 por ciento a un resultado del 65 por ciento supone cinco puntos porcentuales. Los resultados se redondean a un máximo de seis decimales para conservar precisión útil y una salida estable.
Aplique el cálculo de forma coherente y responsable
La herramienta resulta útil cuando la regla oficial ya está definida, pero la escala bruta dificulta interpretar el resultado. Un docente puede revisar una nota antes de publicarla, un estudiante puede saber a qué distancia quedó del requisito y una administración puede aplicar el mismo umbral a numerosos registros. No decide cuál debe ser la nota mínima, ni añade curvas, elimina preguntas, pondera categorías o resuelve reglas institucionales de redondeo. Esas decisiones deben tomarse antes. Si un curso combina trabajos con pesos distintos, calcule primero la nota bruta oficial y su total correspondiente, o utilice el procedimiento aprobado por el centro. Considere el margen una explicación aritmética, no una autorización para contradecir el programa. En automatizaciones, cada solicitud de API cuesta $0.002.
Qué puede hacer con ella
Confirmar el resultado de un examen
Compare los puntos de un estudiante con el mínimo publicado y comunique el porcentaje y el margen exacto.
Explicar una nota cercana al límite
Muestre cuántos puntos brutos y porcentuales separan la nota del requisito sin convertir escalas manualmente.
Automatizar comprobaciones
Aplique un umbral conocido de manera uniforme y conserve campos numéricos claros para informes y auditorías.
Preguntas frecuentes
¿Aprueba una nota exactamente igual al mínimo?
Sí. El mínimo se considera la puntuación necesaria para aprobar; passed será verdadero y ambos márgenes serán cero.
¿Debo introducir el límite en puntos o porcentaje?
Introdúzcalo en puntos brutos, en la misma escala que la nota y el total. La herramienta calcula su porcentaje.
¿Se admiten valores decimales?
Sí. Se aceptan valores decimales finitos para exámenes que conceden crédito parcial.
¿Qué significa un margen negativo?
Significa que la nota está por debajo del límite. Su valor absoluto indica lo que falta en puntos brutos o porcentuales.
¿Aplica curvas o categorías ponderadas?
No. Solo compara la nota y el mínimo suministrados. Aplique antes cualquier curva o ponderación.
¿Cuánto cuesta una solicitud de API?
Cada solicitud de API cuesta $0.002. La versión del navegador puede ejecutar localmente el mismo cálculo determinista.
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
¿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/exam-pass-threshold \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"score":72,"total":100,"passing_mark":70}'const res = await fetch("https://api.kit.forhosting.com/edu/exam-pass-threshold", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"score": 72,
"total": 100,
"passing_mark": 70
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/edu/exam-pass-threshold",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"score": 72,
"total": 100,
"passing_mark": 70
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/exam-pass-threshold", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"score":72,"total":100,"passing_mark":70}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"score":72,"total":100,"passing_mark":70}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/exam-pass-threshold", 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
{
"score": 72,
"total": 100,
"passing_mark": 70
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.exam_pass_threshold",
"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
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. |