Calculadora de nota da prova

Professores, estudantes, plugins de LMS e corretores de tarefa precisam da mesma conversão: o percentual é igual a score dividido por maximum vezes cem, e em seguida uma letra pelos limiares padrão de dez pontos dos Estados Unidos. A aritmética é totalmente determinística, roda grátis no seu navegador e está disponível pela API a US$ 0,002 por solicitação bem-sucedida, sem modelo de linguagem e sem serviço de diário de classe no caminho crítico.

O que é a letra de uma prova e por que a escala de dez pontos é o padrão

O percentual é igual a score dividido por maximum vezes cem.

Contrato de entrada, fórmula, arredondamento e erros

O opcional decimals é um inteiro de 0 a 6 que controla o arredondamento half-up do percentual devolvido; o padrão é 2 casas para que um resultado como 87.5 coincida com as telas usuais do diário de classe. A letra é atribuída a partir desse percentual arredondado para que o número que você mostra e a letra que você mostra não possam discordar: 89.995 com 2 casas vira 90.00, letra A. Um maximum igual a zero ou negativo também falha, porque dividir por um teto não positivo não é percentual de prova. Pontuação negativa falha. Validação falha não é cobrada. Envie por POST um corpo JSON com dois números finitos obrigatórios: score, os pontos obtidos, e maximum, os pontos possíveis. Cada campo pode chegar como número JSON ou como string numérica. Score também aceita os aliases earned, points, raw e raw_score; maximum aceita max, max_score, total e out_of, para que scripts que já falam nesses termos não precisem de um passo de rename. Campos ausentes, strings vazias e valores não finitos falham com invalid_input nomeando o problema. Pontuação que ultrapasse o máximo falha com invalid_input para que crédito extra acima do teto publicado nunca pareça um A bem-sucedido. Em caso de sucesso o corpo ecoa score e maximum, devolve percentage, devolve letter_grade como uma de A, B, C, D ou F e reafirma a identidade no campo formula. Exemplo: score 85 e maximum 100 produz percentage 85 e letra B. Exemplo: score 45 e maximum 50 produz percentage 90 e letra A. Combine o JSON estruturado com o seu próprio boletim se precisar de cortes com mais e menos ou de uma curva; este endpoint devolve só a letra padrão de dez pontos.

Onde uma API de letra de prova justifica o uso

Salas de aula e plataformas de tutoria usam uma calculadora de nota da prova para que o aprendiz converta o quiz de hoje em uma letra sem misturar o máximo nem aplicar peso de ementa que não pertence a um único instrumento. Geradores de exame e corretores de tarefa precisam de um oráculo determinístico que rejeite pontuação negativa e pontuação acima do máximo, em vez de tomar valores absolutos e marcar números trocados como A. Professores e monitores chamam a API em lote por prova para anexar uma coluna verificada de percentual e letra ao exportar uma pilha de pontuações brutas, pegando linhas em que a nota foi digitada acima do total publicado. Plugins de gestão da aprendizagem que já guardam pontos obtidos e pontos possíveis podem mapear esses dois campos em score e maximum e obter uma letra sem montar um banco de diário de classe. Como a implementação é parse puro de nível A, cada chamada bem-sucedida custa o preço-base publicado US$ 0,002, sem tokens de modelo e sem rede de saída. Mantenha as solicitações pequenas, fixe nos testes o percentage arredondado e letter_grade, e você terá letras de prova reproduzíveis para tarefa, workers de borda e scripts de diário sem inventar curva, tabela de mais e menos ou média ponderada de curso na mesma página.