試験成績の計算

百分率は score を maximum で割って百を掛けた値で、続けて米国の標準十点法の閾値から文字評定を付けます。この試験成績計算機は有限の素点と正の満点を受け取り、百分率と A から F までの評定を返し、負の得点や満点を超える得点は拒否します。算術は完全に決定的で、ブラウザでは無料、成功した API 呼び出しは $0.002 です。

試験の文字評定とは何か、十点法が既定である理由

百分率は score を maximum で割って百を掛けた値です。

入力契約、式、丸め、エラー時の挙動

任意の decimals は 0 から 6 の整数で、返す百分率の half-up 丸めを制御します。既定は小数二桁で、87.5 のような結果がよくある成績簿表示と一致します。文字評定はその丸めた百分率から付けるので、表示する数字と表示する文字が食い違いません。小数二桁では 89.995 は 90.00 になり評定 A です。maximum が 0 または負でも失敗します。正でない上限で割っても試験百分率にならないからです。検証失敗は課金されません。必須の有限数二つを含む JSON ボディを POST してください。score は得た点、maximum は満点です。各欄は JSON 数値でも数値文字列でも構いません。score は earned、points、raw、raw_score の別名も受け付け、maximum は max、max_score、total、out_of を受け付けるので、既にその語彙で話すスクリプトは rename せずに済みます。欠落欄、空文字、非有限値は invalid_input で失敗し、問題を明示します。負の得点も失敗します。 満点を超える得点は invalid_input で失敗し、公表上限を超える加点が成功した A に見えないようにします。成功時は score と maximum をエコーし、percentage を返し、letter_grade を A・B・C・D・F のいずれかとし、formula 欄で式を再掲します。例：score 85 と maximum 100 なら percentage 85、評定 B です。例：score 45 と maximum 50 なら percentage 90、評定 A です。プラスマイナスの切れ目や曲線が必要なら、構造化 JSON をご自身の通知表と組み合わせてください。この経路は標準十点法の文字だけを返します。

試験評定 API が価値を持つ場面

教員と助手は答案ごとに API を一括呼び出しし、素点の束を書き出すときに検証済みの百分率と評定の列を付け、公表合計を超えて打たれた行を見つけます。得た点と満点を既に持つ学習管理プラグインは、その二欄を score と maximum に写して文字を得られ、成績簿データベースを立てる必要はありません。実装は純粋 parse のレベル A なので、成功した呼び出しは公表の基本料金 $0.002 で、モデルトークンも外向きネットワークもありません。要求を小さく保ち、テストでは丸めた percentage と letter_grade を固定すれば、宿題、エッジワーカー、成績簿スクリプト向けに再現可能な試験評定が得られます。