ForHosting KIT · 開発者向けツール

成績平均計算機

成績平均計算機は、生徒の点数一覧から算術平均を求め、計算に使った合計と件数も表示します。一人の学習成果の確認、小テストの集計、すべての点数を同じ重みで扱う場合のクラス平均の算出に便利です。0から100までの点数を入力し、必要な小数桁数を選ぶと、検算に役立つ情報を含む結果がすぐに得られます。加重処理は行わないため、各点数は最終的な平均に同じ割合で反映されます。

● Beta無料・ブラウザ内で実行

無料で実行 API仕様を見る

ご利用方法ウェブAPIメールTelegramアプリ近日

計算に含める点数を入力します

まず、結果に同じ重みで反映させる点数をそろえてください。各成績は0から100までの数値として入力します。整数だけでなく小数も使用できるため、84、91.5、77.25のような値を同じ一覧に含められます。目的に合う点数だけを入力することが重要です。個人の平均を求める場合は、一人の生徒が対象の課題で得た点数を使用します。クラス平均の場合は、同じ試験を受けた生徒全員の点数を使用してください。異なる尺度や別の試験を混在させると、数式上は正しくても教育上の意味が乏しい数値になることがあります。同じ点数が複数あっても、それぞれ1件として数えます。90点の生徒が二人いれば、異なる二つの観測値だからです。入力は最低1件、最大1000件です。0未満、100超、空欄、数値以外の値は拒否されるため、誤入力による気づきにくい結果の変化を防げます。課題ごとに重要度が異なる場合は、この等加重の計算ではなく、加重平均用の計算機をご利用ください。

平均・合計・件数の意味を確認します

計算には一般的な算術平均を使用します。最初に、有効な点数をすべて加算して合計を求めます。次に、入力された点数の件数を数えます。最後に合計を件数で割り、平均を算出します。たとえば、80、90、100の合計は270で件数は3なので、平均は90です。三つの値を併記することで検算しやすくなります。表示された平均に件数を掛けると、おおむね合計に戻り、わずかな差がある場合は選択した丸め桁数によるものです。件数は入力漏れの発見にも役立ち、長い名簿から転記するときには特に有効です。小数桁数の設定で変わるのは合計と平均の表示だけであり、点数が削除されたり、寄与率が変わったりすることはありません。成績表では小数第2位までで十分な場合が多い一方、別のシステムで後続計算に使う場合は、より多くの桁が役立ちます。この結果は記述的な要約であり、評定文字への変換や成績に対する価値判断ではありません。

成績表や報告書で適切に活用します

結果を記録する前に、返された件数と含める予定だった点数の数を照合し、合計に明らかな不整合がないか確認してください。件数が一つ少なければ生徒の入力漏れ、合計が不自然に低ければ点数の入力ミスが考えられます。学校、授業、報告システムで採用する丸め方も事前に確認してください。この計算機では小数桁数を0から10まで選べますが、最終成績を表示するまで全精度を保持するなど、教育機関独自の規則が定められている場合があります。単純平均は、すべての観測値が同じ尺度と重要度を持つ場合に最も有用です。課題の重み、単位数、最低点の除外、未提出の扱い、カテゴリ上限、追加点は考慮しません。これらの規則は最終一覧を入力する前に適用するか、目的に合う加重平均計算機をご利用ください。クラスを比較する際も、平均だけを教育や学習の完全な尺度とせず、試験の難易度や集団構成の違いを考慮する必要があります。API は1リクエスト $0.002 で、ブラウザー版と同じ決定論的な計算を使用します。

活用例

一人の生徒の平均を求める

同じ重みの課題や小テストを平均し、返された合計と件数を使って結果を確認できます。

クラスの試験結果を集計する

一つの試験における全生徒の点数から、含まれた件数を明示したクラス平均を求められます。

成績表の計算を検算する

等加重の平均を独立して再計算し、合計、件数、平均を別のシステムと比較できます。

よくある質問

平均はどのように計算されますか？

すべての点数を加算して合計を求め、その合計を点数の件数で割ります。各点数の重みは同じです。

料金はいくらですか？

ブラウザーでの計算は無料です。API は1リクエスト $0.002 です。

小数の点数も入力できますか？

はい。各点数には、0から100までの有限な整数または小数を使用できます。

加重成績に対応していますか？

いいえ。すべての点数が同じ割合で反映されます。課題やカテゴリの重要度が異なる場合は、加重平均計算機をご利用ください。

未入力の成績は0点として扱われますか？

いいえ。一覧に明示的に入力された数値だけを数えます。評価規則で0点を付ける場合に限り、ご自身で0を入力してください。

開発者向け — APIアクセス

このページの機能はすべてAPIからも利用できます。自社システムに組み込みたいチーム向けのセクションです。それ以外の方は上のツールをそのままお使いください。

エンドポイント

POSThttps://api.kit.forhosting.com/edu/average-of-grades

Bearerトークンで認証し、POST1回でタスクをキューに登録します。結果はWebhookまたは署名付きリンクで受け取れます。

お使いのスタックから呼び出す

curl -X POST https://api.kit.forhosting.com/edu/average-of-grades \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grades":[88,92,76,84]}'

const res = await fetch("https://api.kit.forhosting.com/edu/average-of-grades", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "grades": [
      88,
      92,
      76,
      84
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/average-of-grades",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "grades": [
        88,
        92,
        76,
        84
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/average-of-grades", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"grades":[88,92,76,84]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"grades":[88,92,76,84]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/average-of-grades", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "grades": [
    88,
    92,
    76,
    84
  ]
}

レスポンス例

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

非同期APIです。task_idは即時に返ります。ポーリングは1秒あたり1リクエストまでです。

料金

1リクエストあたり$0.002

単価はすべて公開しています。トークン換算や独自クレジットはありません。失敗したタスクは課金されません。

エラー

HTTP	コード	意味
`401`	`unauthorized`	APIキーが無効か、指定されていません。Authorizationヘッダーを確認してください。
`402`	`insufficient_balance`	残高が不足しています。チャージ後に再度お試しください。
`404`	`unknown_type`	指定されたタスクタイプは存在しません。タイプ名を確認してください。
`429`	`rate_limited`	リクエストが多すぎます。しばらく待ってから再度お試しください。

KITの完全なドキュメントを見る →