ForHosting KIT · 開発者向けツール

10ピンボウリングのスコアをフレーム別に計算

この計算機は、10ピンボウリングの全フレームの投球記録から公式スコアを算出します。各投球で倒したピン数を入力し、ストライクは1投だけのフレームとして、ボーナス投球は第10フレーム内に記録してください。結果には各フレームの得点、フレームごとの累計、最終スコアが表示されます。成立しない組み合わせは自動修正せずエラーにするため、スコアシートの確認、採点ソフトのテスト、ストライクやスペアの規則の学習に利用できます。

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

無料で実行 API仕様を見る

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

10フレームを正しい形式で入力します

プレー順に、ちょうど10個のフレーム配列を指定してください。第1から第9フレームのストライクは[10]と記録します。ストライク以外は必ず2投で、スペアなら[7, 3]、オープンフレームなら[7, 2]のように入力します。0も投球記録です。9本の後にガターなら、値を1つだけにせず[9, 0]としてください。第10フレームにはボーナス投球も含めます。ストライクなら[10, 8, 1]のように2投、スペアなら[6, 4, 7]のように1投を追加します。オープンなら通常の2投だけです。各値は0から10までの整数でなければなりません。この計算機は終了したゲームを対象にします。後続投球がなければストライクやスペアの得点を確定できないためです。フレーム単位の配列は紙のスコアシートと照合しやすく、ボーナス計算に必要な投球順も保ちます。

ストライク、スペア、第10フレームの仕組み

オープンフレームは、そのフレームで倒したピン数が得点です。スペアは10点に次の1投のピン数を加えます。その投球が次のフレームにあっても同じです。ストライクは10点に次の2投を加えるため、ボーナスが1つまたは2つ先のフレームまで及ぶ場合があります。連続ストライクでは、最初のストライクに次の2回のストライクが加算され、30点になります。第10フレームの追加投球は第11フレームではなく、第10フレーム自体のボーナスを確定するものです。ストライクの後はピンが再配置されます。第10フレームの2投目もストライクなら、最後は0から10まで自由です。2投目が10未満なら2投目と3投目は同じラックを使うため、合計は10以下です。第10フレームのスペア後は、新しく並べたピンを最後の1投で最大10本倒せます。こうした検証により、見た目は自然でも実際には成立しない投球列を採点しません。

結果と入力エラーを確認します

応答にはゲームを確認する3種類の値があります。total_scoreは最終スコアで、0からパーフェクトゲームの上限300までです。frame_scoresはボーナス適用後の各フレーム得点、cumulative_scoresは各フレーム終了時の累計で、通常のスコアシートに記入する数値に対応します。この区別により、ストライク欄に見えるピン数より得点が大きくなる理由を確認できます。また、2つの採点処理を自動比較するとき、最終値だけでなく最初に相違したフレームを特定できます。不正な入力には部分スコアを返さず、エラーを返します。10フレーム未満、第9までのストライクに2投目がある、同じラックで10本を超える、第10フレームの必須ボーナスがない、オープンの後に余分なボーナスがある、といった例が対象です。API計算は1回$0.002で、ブラウザー版は手早い確認のため端末内で動作します。

活用例

リーグのスコアシートを確認

結果を登録する前に各フレームを再計算し、累計と最終スコアを照合できます。

採点ソフトをテスト

ストライク、スペア、オープン、第10フレームの確定ケースを回帰テストに利用できます。

公式ルールを説明

後続の1投または2投が得点を変える過程を、計算を省略せずに示せます。

よくある質問

ストライクはどのように入力しますか？

第1から第9フレームでは、10だけを含む1投の配列にします。第10では同じ配列に2回のボーナス投球も含めます。

スペアはどのように入力しますか？

合計が10になる2投を指定します。第10フレームのスペアでは、3つ目の値としてボーナス投球も必要です。

パーフェクトゲームに対応していますか？

はい。最初の9フレームを[10]、第10を[10, 10, 10]とすると、公式スコアは300です。

第10フレームが拒否されるのはなぜですか？

ストライクには2投、スペアには1投のボーナスが必要で、オープンには追加できません。ピンの再配置規則も満たす必要があります。

計算料金はいくらですか？

APIでの計算は1回$0.002です。ブラウザー計算機では同じ決定的な処理を端末内で実行します。

進行中のゲームを送信できますか？

いいえ。公式の最終スコア確定に必要な10フレームとすべてのボーナス投球が必要です。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/game/bowling-score-calculate

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

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

curl -X POST https://api.kit.forhosting.com/game/bowling-score-calculate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"frames":[[10],[7,3],[9,0],[10],[0,8],[8,2],[0,6],[10],[10],[10,8,1]]}'

const res = await fetch("https://api.kit.forhosting.com/game/bowling-score-calculate", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "frames": [
      [
        10
      ],
      [
        7,
        3
      ],
      [
        9,
        0
      ],
      [
        10
      ],
      [
        0,
        8
      ],
      [
        8,
        2
      ],
      [
        0,
        6
      ],
      [
        10
      ],
      [
        10
      ],
      [
        10,
        8,
        1
      ]
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/game/bowling-score-calculate",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "frames": [
        [
            10
        ],
        [
            7,
            3
        ],
        [
            9,
            0
        ],
        [
            10
        ],
        [
            0,
            8
        ],
        [
            8,
            2
        ],
        [
            0,
            6
        ],
        [
            10
        ],
        [
            10
        ],
        [
            10,
            8,
            1
        ]
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/game/bowling-score-calculate", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"frames":[[10],[7,3],[9,0],[10],[0,8],[8,2],[0,6],[10],[10],[10,8,1]]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"frames":[[10],[7,3],[9,0],[10],[0,8],[8,2],[0,6],[10],[10],[10,8,1]]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/game/bowling-score-calculate", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "frames": [
    [
      10
    ],
    [
      7,
      3
    ],
    [
      9,
      0
    ],
    [
      10
    ],
    [
      0,
      8
    ],
    [
      8,
      2
    ],
    [
      0,
      6
    ],
    [
      10
    ],
    [
      10
    ],
    [
      10,
      8,
      1
    ]
  ]
}

レスポンス例

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