オンラインゲーム向けの独立したサイコロ

サーバー上の誰にも細工できない出目。

RandomDice.org は、暗号学的に安全で偏りのない整数と、毎回の公開レシートを発行します。プレイヤーは数字を確認できます。スタジオがサイコロを静かに「設定」することはできません。

無料のAPIキーを取得

キーごとにUTCの1日あたり10,000回まで無料。それ以上は ご連絡ください。

デモロール · サイコロ

クライアント

すでに公開で振っているゲーム。

これらのスタジオは戦闘、戦利品、卓上のロールで RandomDice.org を呼び出します。ロゴをクリックすると、そのゲームの公開ロール記録が開きます。直近15分のロール、必須の player_name、パラメータ、時刻が含まれます。そのページでニックネームを検索してください。記録と違う数字を出すゲームは、私たちの結果を使っていません。

目的

プレイヤーはハウスの乱数を信じる必要がない。

ホスト型のゲームでは、サーバーはスタジオのものです。「ランダム」なサイコロは重み付け、振り直し、後からの差し替えができます。それは細工であり、ロールではありません。RandomDice.org はゲームの外にあります。サーバーが数を求め、私たちは PHP の random_int()(CSPRNG)で生成し、掲載ゲームごとの直近15分のロールを、必須の player_name を含めて公開します。誰でも値を確認できます。

  • 偏りのない範囲。 min から max までの一様な整数。既定は 1–6。
  • 公開ロール。 掲載ゲームの直近15分のロールは誰でも見られます。ニックネーム、値、パラメータ、時刻です。クライアントのロゴをクリックしてニックネームを検索してください。
  • 公開レシート。 各呼び出しは id と verify_url も返します。
  • 無料枠。 キーごとにUTCの1日あたり 10,000 回のAPI呼び出し。それを超える場合は ご連絡ください。

使い方

JSON APIが一つ。どこからでも呼べます。

アドレスバー、curl、fetch、Python、Java、Godot の HTTP、Unity、JSON を送れる古いバックエンドから使えます。HTTPS に届くものなら何でも構いません。Bearer トークン、X-Api-Key、またはクエリの api_key で認証します。

エンドポイント

GET or POST https://randomdice.org/api/v1/roll

パラメータ

player_name(必須、1–40文字)、min(既定1)、max(既定6)、count(1–100、既定1)。認証は Authorization: Bearer、X-Api-Key、または api_key(ブラウザの GET に便利)。任意の独自文字列は追加フィールドか params オブジェクトで渡します。最大10件、キーと値はそれぞれ最大32文字。保存され、公開記録に表示されます。player_name のない呼び出しは拒否されます。count がまとめてでも、HTTPリクエスト1件は枠の1回として数えます。

枠

UTCの1日あたり 10,000 回。ヘッダーは X-RateLimit-Limit、Remaining、Reset。超過すると 429 を返します。

ブラウザの GET — アドレスバーに貼り付け:https://randomdice.org/api/v1/roll?api_key=rd_live_YOUR_KEY&player_name=FlashMan&min=1&max=6&count=1
curl -H "Authorization: Bearer rd_live_YOUR_KEY" \
  "https://randomdice.org/api/v1/roll?player_name=FlashMan&min=1&max=6&count=1&match_id=arena-12"
fetch("https://randomdice.org/api/v1/roll", {
  method: "POST",
  headers: {
    "Authorization": "Bearer rd_live_YOUR_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    player_name: "FlashMan",
    min: 1,
    max: 6,
    count: 3,
    params: { match_id: "arena-12", round: "3" }
  })
})
import requests
r = requests.get(
  "https://randomdice.org/api/v1/roll",
  params={"player_name": "FlashMan", "min": 1, "max": 20, "count": 1, "match_id": "arena-12"},
  headers={"Authorization": "Bearer rd_live_YOUR_KEY"},
)
print(r.json())

成功時の応答には player_name、params、values、id、verify_url、そして(掲載後は)public_log_url が含まれます。これらのリンクをプレイヤーに示してください。直近15分のロールはゲームページで公開され、独自パラメータを含めてニックネームで検索できます。エラーは JSON です: { "ok": false, "error": { "code", "message" } }。

APIキー

ワンステップでキーを発行。

承認待ちはありません。キーはこのページに一度だけ表示され、メールでも送られます。枠はUTCの1日あたり 10,000 回から始まります。ゲームを申請するときに同じキーを貼ると、トップのロゴから公開ロール記録を開けます。

キャプチャ画像

申請

ゲームを掲載し、証明書の印を受け取る。

これはAPIを止めません。確認済みクライアント一覧と公開ロール記録です。上で作ったAPIキー全文を貼ってください。承認後、トップのロゴがクリックでき、ニックネームで絞れる直近15分のロールが開きます。保留中の掲載は、メールで承認または却下するまで待ち行列に残ります。

必須です。「APIキー」の全文を貼ってください。短い接頭辞ではありません。秘密そのものではなく、そのキーへの関連だけを保存します。承認後、ロゴをクリックするとプレイヤー絞り込み付きで直近15分のロールが表示されます。

キャプチャ画像

連絡

枠、提携、またはロールの問題。

このページにメールアドレスは掲載しません。フォームを送ると、入力した宛先へ返信します。

キャプチャ画像