ForHosting KIT · Ferramentas para dev

Calculadora de nota atual

O percentual da nota atual responde a uma pergunta objetiva: qual é o seu desempenho nas atividades que já foram corrigidas?

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Informe os pontos obtidos e possíveis de cada atividade e marque como não corrigido o trabalho que ainda não recebeu nota. A calculadora exclui essas atividades pendentes dos dois totais, soma os pontos avaliados e apresenta o percentual conquistado até agora. Assim, você vê sua situação de hoje sem transformar trabalhos futuros ou não devolvidos em zeros.

Informe os pontos do boletim com precisão

Comece pelas atividades exibidas no boletim e copie os pontos obtidos e possíveis. Uma prova com 18 de 20 deve ter 18 pontos obtidos e 20 possíveis. Mantenha cada atividade em uma linha para conferir os dados depois. Marque uma linha como corrigida somente quando houver uma nota publicada. Se um projeto mostrar 100 pontos possíveis, mas ainda não tiver resultado, mantenha-o como não corrigido; ele será ignorado. Não use zero provisório, a menos que zero seja a nota registrada. Um zero verdadeiro entra no cálculo, enquanto uma nota em branco ou pendente não entra. Os nomes são opcionais, mas rótulos como “Prova 1” ajudam a encontrar linhas duplicadas ou esquecidas.

Entenda o cálculo baseado em pontos

A ferramenta soma os pontos obtidos nas linhas corrigidas, soma os pontos possíveis dessas mesmas linhas, divide o primeiro total pelo segundo e multiplica por 100. Por exemplo, 18 de 20 e 42 de 50 resultam em 60 de 70, ou 85.71 por cento com duas casas decimais. Linhas não corrigidas ficam fora do numerador e do denominador, evitando que trabalho pendente seja tratado como zero. O resultado é uma nota atual por pontos e pode não coincidir com a nota oficial. Algumas disciplinas ponderam provas, tarefas e participação, descartam resultados ou aplicam bônus. Se houver categorias ponderadas, consulte o plano da disciplina e confira nos totais quais pontos entraram no cálculo.

Interprete o resultado como retrato do momento

Considere o percentual um retrato atual, não uma previsão da nota final. Ele descreve apenas o que já foi avaliado e pode mudar bastante quando uma prova ou um projeto importante for corrigido. Compare os totais obtidos e possíveis com o boletim e investigue qualquer diferença. Refaça o cálculo quando surgir uma nota, quando corrigir um dado ou quando confirmar se um espaço vazio é realmente zero. As contagens de itens corrigidos e pendentes ajudam a verificar se a lista está completa. Para planejar, combine o resultado com os pesos e trabalhos restantes descritos no plano da disciplina. O cálculo é determinístico, sem rede, aleatoriedade ou relógio, e repete o resultado para as mesmas entradas. No navegador é gratuito; pela API custa US$ 0,002.

Casos de uso

Consultar a situação de hoje

Reúna todas as notas publicadas sem incluir trabalhos que ainda não foram devolvidos.

Auditar o total do boletim

Compare os totais de pontos obtidos e possíveis com aqueles exibidos pelo sistema da disciplina.

Atualizar após uma nova nota

Marque como corrigida uma atividade antes pendente e recalcule imediatamente o percentual atual.

Perguntas frequentes

O que a calculadora ignora?

Ela ignora toda atividade marcada como não corrigida, excluindo os pontos obtidos e possíveis.

Uma atividade sem nota deve ser zero?

Somente se zero for uma nota realmente publicada. Mantenha como não corrigido o que ainda aguarda avaliação.

A ferramenta aceita categorias ponderadas?

Não. Ela calcula um percentual por pontos; pesos de categorias podem gerar uma nota oficial diferente.

Os pontos obtidos podem superar os possíveis?

Sim. Isso é permitido porque o professor pode conceder pontos extras em uma atividade corrigida.

Como o percentual é calculado?

Os pontos obtidos são divididos pelos possíveis nas atividades corrigidas, multiplicados por 100 e arredondados.

Quanto custa uma solicitação pela API?

O preço-base é US$ 0,002 por solicitação. O mesmo cálculo determinístico é gratuito no navegador.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

POSThttps://api.kit.forhosting.com/edu/current-grade-percentage

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

curl -X POST https://api.kit.forhosting.com/edu/current-grade-percentage \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}'

const res = await fetch("https://api.kit.forhosting.com/edu/current-grade-percentage", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "assignments": [
      {
        "name": "Quiz 1",
        "earned": 18,
        "possible": 20,
        "graded": true
      },
      {
        "name": "Essay",
        "earned": 42,
        "possible": 50,
        "graded": true
      },
      {
        "name": "Final project",
        "possible": 100,
        "graded": false
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/current-grade-percentage",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "assignments": [
        {
            "name": "Quiz 1",
            "earned": 18,
            "possible": 20,
            "graded": true
        },
        {
            "name": "Essay",
            "earned": 42,
            "possible": 50,
            "graded": true
        },
        {
            "name": "Final project",
            "possible": 100,
            "graded": false
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/current-grade-percentage", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"assignments":[{"name":"Quiz 1","earned":18,"possible":20,"graded":true},{"name":"Essay","earned":42,"possible":50,"graded":true},{"name":"Final project","possible":100,"graded":false}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/current-grade-percentage", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemplo de requisição

{
  "assignments": [
    {
      "name": "Quiz 1",
      "earned": 18,
      "possible": 20,
      "graded": true
    },
    {
      "name": "Essay",
      "earned": 42,
      "possible": 50,
      "graded": true
    },
    {
      "name": "Final project",
      "possible": 100,
      "graded": false
    }
  ]
}

Exemplo de resposta

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

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

max_items 500

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →