ForHosting KIT · 開発者向けツール

クイズ大会の得点・賭け点・順位表を計算

このクイズ大会得点計算ツールは、採点済みの各チームの回答から試合全体の得点履歴を作成します。通常ラウンドの名称と配点、各回答の正誤、各チームの最終賭け点とその正誤を入力してください。ラウンドごとの獲得点、累計点、同順位、最終順位表、すべての優勝チームを確認できます。また、賭けラウンド直前の持ち点を超える賭け点はエラーとして拒否されるため、不正な得点状態を防げます。

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

無料で実行 API仕様を見る

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

ラウンドとチーム回答を同じ順序で設定します

最初に、通常ラウンドを実施順に登録してください。各ラウンドには重複しない名称と、0 以上の配点が必要です。次に、各チームについてラウンドごとに 1 つの真偽値を指定します。true は正解として認められた回答、false は不正解を表します。回答の位置はラウンドの位置と完全に一致させる必要があります。たとえば 3 番目が音楽ラウンドなら、全チームの 3 番目の回答はその音楽ラウンドの結果です。この明示的な対応により採点を監査しやすくなり、回答の欠落によって後続の得点がずれる事故を防げます。順位表の各履歴でチームを識別するため、チーム名も重複できません。本ツールは自由記述の回答を判定せず、表記の揺れを正解とするかどうかも決めません。異議がある場合は先に主催者が裁定し、確定した結果を真偽値で入力してから計算してください。大会規則で認められていれば、小数の配点や賭け点も使用できます。ただし、すべて有限かつ 0 以上の数値でなければなりません。

各ラウンド後の累計順位を確認します

通常ラウンドでは、正解したチームに設定された配点を加算し、不正解には 0 点を加算します。その後、累計点の高い順に全チームを並べ、完全な順位表の履歴を保存します。各行には、そのラウンドで得た点数と更新後の累計点が両方含まれます。そのため司会者は、何が変わり、各チームが現在どの位置にいるかを明確に説明できます。累計点が等しいチームには同じ競技順位が付与されます。たとえば 2 チームが 1 位で並ぶ場合、両方が 1 位となり、次のチームは 3 位です。同点内では JSON と表示表を常に同じ結果にするため、チーム名をアルファベット順に並べるだけです。この順序は勝敗を決めるタイブレークではありません。すべての履歴が残るため、ライブ表示、終了後の確認、疑義のある得点の調査に利用できます。最終表や手書きメモだけから再計算することなく、最終得点をラウンドごとに遡って検証できます。

最終賭け点を安全に反映して優勝者を決めます

賭けラウンドは、すべての通常ラウンドを採点した後に処理します。各チームは 0 以上の賭け点と、最終回答が正解だったかどうかを指定します。正解なら賭け点を加算し、不正解なら同じ点数を減算します。いずれかの得点を変更する前に、全チームの賭け点が現在の持ち点以下であることを確認します。1 チームでも上限を超えていれば、チーム名、賭け点、利用可能な得点を示す入力エラーとなり、結果は返しません。この一括検証により、不正な試合状態に基づく順位表の生成を防ぎます。現在の持ち点と同額を賭けることは可能なので、全点を賭けて不正解だったチームは 0 点になります。最終ラウンドも独立した順位表履歴として表示され、正または負のラウンド得点と更新後の累計点を確認できます。応答には参照しやすい最終順位表と優勝者一覧も含まれます。最高得点が同点なら、架空のタイブレークを設けず、該当する全チームを優勝者として返します。API リクエストの基本料金は表示中の $0.002 です。

活用例

パブクイズの決勝を運営します

順位の変動と最終賭け点を確認し、単独優勝または正式な同点結果を発表できます。

ライブ順位表を更新します

各ラウンドの回答が確定するたびに、累計順位の履歴を使って画面を更新できます。

疑義のある得点を監査します

ラウンドごとの獲得点と累計点を調べ、チームの得点が変化した箇所を正確に特定できます。

よくある質問

通常ラウンドはどのように採点されますか？

正解にはそのラウンドで設定した配点を加算し、不正解には 0 点を加算します。

賭け回答が不正解の場合はどうなりますか？

チームの得点から賭け点を減算します。正解の場合は同じ点数を加算します。

持ち点をすべて賭けられますか？

はい。現在の持ち点と同額まで賭けられますが、持ち点を超える指定はできません。

同点の順位はどのように扱われますか？

累計点が同じチームは同順位です。安定した表示のため名前順に並べますが、首位の全チームを優勝者として返します。

回答数をラウンド数に合わせる必要がありますか？

はい。各チームは通常ラウンドごとに 1 つ、ラウンド一覧と同じ順序で真偽値を指定する必要があります。

API リクエストの料金はいくらですか？

各 API リクエストには表示中の基本料金 $0.002 が適用されます。このページのブラウザー版は無料です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/game/trivia-night-round-scoring

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

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

curl -X POST https://api.kit.forhosting.com/game/trivia-night-round-scoring \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"rounds":[{"name":"General Knowledge","point_value":10},{"name":"Picture Round","point_value":20}],"teams":[{"name":"The Quizzards","answers":[true,false],"wager_amount":5,"wager_correct":true},{"name":"Fact Hunters","answers":[true,true],"wager_amount":10,"wager_correct":false}]}'

const res = await fetch("https://api.kit.forhosting.com/game/trivia-night-round-scoring", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "rounds": [
      {
        "name": "General Knowledge",
        "point_value": 10
      },
      {
        "name": "Picture Round",
        "point_value": 20
      }
    ],
    "teams": [
      {
        "name": "The Quizzards",
        "answers": [
          true,
          false
        ],
        "wager_amount": 5,
        "wager_correct": true
      },
      {
        "name": "Fact Hunters",
        "answers": [
          true,
          true
        ],
        "wager_amount": 10,
        "wager_correct": false
      }
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/game/trivia-night-round-scoring",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "rounds": [
        {
            "name": "General Knowledge",
            "point_value": 10
        },
        {
            "name": "Picture Round",
            "point_value": 20
        }
    ],
    "teams": [
        {
            "name": "The Quizzards",
            "answers": [
                true,
                false
            ],
            "wager_amount": 5,
            "wager_correct": true
        },
        {
            "name": "Fact Hunters",
            "answers": [
                true,
                true
            ],
            "wager_amount": 10,
            "wager_correct": false
        }
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/game/trivia-night-round-scoring", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"rounds":[{"name":"General Knowledge","point_value":10},{"name":"Picture Round","point_value":20}],"teams":[{"name":"The Quizzards","answers":[true,false],"wager_amount":5,"wager_correct":true},{"name":"Fact Hunters","answers":[true,true],"wager_amount":10,"wager_correct":false}]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"rounds":[{"name":"General Knowledge","point_value":10},{"name":"Picture Round","point_value":20}],"teams":[{"name":"The Quizzards","answers":[true,false],"wager_amount":5,"wager_correct":true},{"name":"Fact Hunters","answers":[true,true],"wager_amount":10,"wager_correct":false}]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/game/trivia-night-round-scoring", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "rounds": [
    {
      "name": "General Knowledge",
      "point_value": 10
    },
    {
      "name": "Picture Round",
      "point_value": 20
    }
  ],
  "teams": [
    {
      "name": "The Quizzards",
      "answers": [
        true,
        false
      ],
      "wager_amount": 5,
      "wager_correct": true
    },
    {
      "name": "Fact Hunters",
      "answers": [
        true,
        true
      ],
      "wager_amount": 10,
      "wager_correct": false
    }
  ]
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

`max_teams`	50
`max_rounds`	20

エラー

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

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