ForHosting KIT · 開発者向けツール

シード付きプレゼント企画の当選者を再現可能に抽選

このシード付き当選者抽選ツールは、順序を固定した応募者リストから1名を選び、リスト、重み、シードが同じであれば常に同じ結果を返します。各応募者を1口にすることも、追加条件、複数口の応募券、公開済みの規約などに応じて口数を増やすこともできます。時計や非公開の乱数源を使わないため、シードと入力データを結果と一緒に保存し、後日同じ抽選を再実行して、当選者がどのように選ばれたかを正確に示せます。

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

無料で実行 API仕様を見る

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

正確な重みを付けた応募者リストを順番どおりに用意します

応募者1名につき1行を作り、意図して決めた安定した順序を維持してください。各行には空でない名前が必要です。省略可能なentriesは正の整数です。省略すると1口、2を指定すると当選確率の重みが2倍になり、以後も同様に扱われます。5口の応募者は仮想的なくじ箱の5か所を占め、1口の応募者は1か所を占めます。同姓同名や重複した名前は、自動では統合されません。別々の正当な応募記録である可能性があり、無断でまとめると公表した確率が変わるためです。元データに重複が含まれ得る場合は、抽選前に統合するかどうかを決め、その判断をキャンペーン記録に残してください。また、シードを公表する前に、最終的なリストと順序を確定してください。並べ替え、行の追加や削除、名前の修正、口数の変更を行うと重み付き範囲が変わり、当選者も変わる可能性があります。最大10,000行まで処理でき、端数を丸めたり重み0の仮行を受け入れたりせず、すべての口数を検証します。したがって、送信した各行が必ず抽選に参加し、指定した口数がそのまま当選確率に反映されます。

シードを使って抽選を再現可能にします

シードには、空でない任意の文字列を使用できます。たとえば、キャンペーン識別子と締切日を示すラベルを組み合わせられます。ツールは入力された文字列を文書化されたハッシュ方式で固定の符号なし32ビット値に変換し、重み付き応募総数の範囲内の1位置へ割り当てます。その後、指定順に応募者を調べ、累積範囲にその位置を含む行を返します。シード、応募者の順序、名前、口数がすべて同一なら、APIでもブラウザーでも必ず同じ出力になります。大文字と小文字、空白、句読点も結果に影響するため、後から入力し直すのではなく、元の文字列を正確に保存してください。公開抽選では、応募締切前にシードの取得方法を決めておくことを推奨します。たとえば、締切後に公表される明確な外部イベントの値を指定できます。このツールは決定論的であり、暗号学的乱数を生成するものではありません。目的は、選択を再現しやすく監査しやすくすることであり、予測不能な秘密を作ることではありません。参加者や主催者が予想結果を見てリストを変更できる間は、自由に選んだシードを先に公開しないでください。

当選結果を記録して検証します

出力には、当選者名、0から始まる当選行のインデックス、同じく0から始まる重み付き当選位置、総応募口数、シードから算出した数値ハッシュが含まれます。これらの項目と完全な入力データを、企画の記録として一緒に保管してください。第三者が同じ順序の行と同じシードを送信すれば、総数を確認し、説明のないランダムボタンや画面画像を信用することなく、同じ当選者を得られます。行インデックスがあるため、表示名が同じ2件の記録も区別できます。また、重み付き位置を見ると、仮想的なくじ箱のどこに選択が入ったかを確認できます。再実行した結果が異なる場合は、保存済み入力を1文字ずつ比較してください。名前の前後空白を除いた、行を並べ替えた、重みを修正した、シードの大文字と小文字を変えた、といった小さな差でも別の抽選になります。ブラウザー版は透明性のある手動抽選に適しています。同じ処理をキャンペーン管理や監査記録で自動化する場合、APIは1回$0.002です。どちらもネットワーク、現在時刻、変更可能な状態を使わないため、実行環境や日付によって答えは変わりません。

活用例

SNS企画の当選者を決める

締切後に有効な応募者名を確定し、シードを公開または保存して、後から再現できる当選者を選びます。

追加応募口数の規約を反映する

条件を満たす行動に多い口数を割り当て、記録された重みに比例する抽選を維持します。

キャンペーン抽選を監査する

順序付き入力と返されたハッシュ情報を保存し、第三者が発表結果を独立して再現できるようにします。

よくある質問

抽選1回の料金はいくらですか？

APIは1回$0.002です。同じ決定論的な計算をブラウザーで無料実行することもできます。

応募口数を省略するとどうなりますか？

その応募者には1口が割り当てられます。明示する重みは正の整数でなければなりません。

同じシードなら常に同じ当選者になりますか？

はい。シードと、名前および口数を含む順序付き応募者リスト全体が同一であることが条件です。

応募者の順序を変えると結果に影響しますか？

はい。順序によって重み付き範囲が決まるため、行の並べ替えは別の抽選入力として扱われます。

暗号学的にランダムな抽選ですか？

いいえ。再現性を重視した透明な決定論的抽選です。予測困難性が必要な場合は、誰も操作できないシード源を使用してください。

重複する名前を別々に残すのはなぜですか？

重複記録が意図的な場合もあるため、受け取った各行を維持します。返された行インデックスで当選記録を特定できます。

開発者向け — APIアクセス

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

エンドポイント

POSThttps://api.kit.forhosting.com/game/giveaway-winner-pick

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

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

curl -X POST https://api.kit.forhosting.com/game/giveaway-winner-pick \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"entrants":[{"name":"Avery","entries":1},{"name":"Blake","entries":3},{"name":"Casey"}],"seed":"spring-campaign-2026"}'

const res = await fetch("https://api.kit.forhosting.com/game/giveaway-winner-pick", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "entrants": [
      {
        "name": "Avery",
        "entries": 1
      },
      {
        "name": "Blake",
        "entries": 3
      },
      {
        "name": "Casey"
      }
    ],
    "seed": "spring-campaign-2026"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/game/giveaway-winner-pick",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "entrants": [
        {
            "name": "Avery",
            "entries": 1
        },
        {
            "name": "Blake",
            "entries": 3
        },
        {
            "name": "Casey"
        }
    ],
    "seed": "spring-campaign-2026"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/game/giveaway-winner-pick", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"entrants":[{"name":"Avery","entries":1},{"name":"Blake","entries":3},{"name":"Casey"}],"seed":"spring-campaign-2026"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"entrants":[{"name":"Avery","entries":1},{"name":"Blake","entries":3},{"name":"Casey"}],"seed":"spring-campaign-2026"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/game/giveaway-winner-pick", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

リクエスト例

{
  "entrants": [
    {
      "name": "Avery",
      "entries": 1
    },
    {
      "name": "Blake",
      "entries": 3
    },
    {
      "name": "Casey"
    }
  ],
  "seed": "spring-campaign-2026"
}

レスポンス例

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

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

料金

1リクエストあたり$0.002

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

制限

max_items 10000

エラー

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

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