ForHosting KIT · 開発者向けツール

試験の合格点チェック：得点率と合格点との差

この合格点チェッカーは、取得した素点、満点、合格に必要な最低点の3つから明確な判定を返します。合否だけでなく、得点率と合格基準の割合を計算し、合格点を上回った点数または不足した点数を、素点とパーセントポイントの両方で示します。普段と異なる配点の試験でも、結果を正確に把握できます。

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

無料で実行 API仕様を見る

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

得点と合格点を同じ尺度で入力します

取得した素点、試験の満点、合格に必要な素点を、すべて同じ尺度で入力してください。たとえば満点が80点、得点が58点、合格点が48点なら、58、80、48を入力します。48点が60パーセントに相当するからといって、合格点に60を入力しないでください。割合への変換は本ツールが行います。部分点がある試験では小数も利用できます。得点と合格点はゼロ以上かつ満点以下である必要があり、満点はゼロより大きくなければなりません。同じ尺度を使うことで、点数と割合を直接比較する誤りを防げます。入力された基準以外の採点方針を推測することはありません。

合否、割合、差の意味を確認します

素点が合格点以上の場合、passed は true です。合格点は最低限必要な点数なので、両者が等しい場合も合格です。percentage は満点に対する得点率、passing_percentage は同じ尺度で表した合格基準です。margin_points は得点から合格点を引いた値で、正なら基準より上、ゼロなら基準と一致、負なら不足を表します。margin_percentage_points は同じ差を満点に対する割合で示します。合格基準が60パーセントで結果が65パーセントなら、差は5パーセントポイントです。小数を含む採点でも必要な精度を保ち、安定した結果にするため、最大6桁の小数に丸めます。

定められた採点規則に沿って利用します

公式の合格基準は決まっているものの、素点の尺度が分かりにくい場面に適しています。教員は成績公開前の確認に、受験者は合格点までの距離の把握に、事務担当者は複数の記録へ同一基準を適用する際に利用できます。本ツールは合格点を決定せず、得点調整、設問の除外、項目別の重み付け、学校独自の丸め規則も適用しません。これらは入力前に確定してください。複数課題を異なる比率で合算する場合は、承認された方法で公式の合計点と満点を先に算出します。返される差は算術的な説明であり、規程を変更する根拠ではありません。自動処理での API 利用は1回 $0.002 です。

活用例

個別の試験結果を確認します

素点を公表済みの合格点と比較し、得点率と正確な差を分かりやすく示します。

わずかな不合格を説明します

手作業で換算せず、不足した素点とパーセントポイントを確認できます。

合否確認を自動化します

既知の基準を一貫して適用し、報告や監査に使える数値を保持します。

よくある質問

得点が合格点と同じ場合は合格ですか？

はい。合格点は必要な最低点なので、passed は true となり、2つの差はゼロです。

合格基準は点数と割合のどちらで入力しますか？

得点と満点と同じ尺度の素点で入力してください。割合は本ツールが計算します。

小数の値を使用できますか？

はい。部分点がある試験では有限の小数値を利用できます。

差が負の場合は何を意味しますか？

得点が合格点を下回っています。絶対値が不足した素点またはパーセントポイントです。

得点調整や重み付けを行いますか？

いいえ。入力された得点と合格点だけを比較します。調整は事前に適用してください。

API の料金はいくらですか？

API は1回 $0.002 です。ブラウザー版では同じ決定的な計算をローカルで実行できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/edu/exam-pass-threshold

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

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

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)

リクエスト例

{
  "score": 72,
  "total": 100,
  "passing_mark": 70
}

レスポンス例

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.exam_pass_threshold",
  "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の完全なドキュメントを見る →