オンラインゲーム向けの独立したサイコロ
サーバー上の誰にも細工できない出目。
RandomDice.org は、暗号学的に安全で偏りのない整数と、毎回の公開レシートを発行します。プレイヤーは数字を確認できます。スタジオがサイコロを静かに「設定」することはできません。
キーごとに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分のロールが開きます。保留中の掲載は、メールで承認または却下するまで待ち行列に残ります。
連絡
枠、提携、またはロールの問題。
このページにメールアドレスは掲載しません。フォームを送ると、入力した宛先へ返信します。