给在线游戏的独立骰子

服务器上谁也改不了的掷骰。

RandomDice.org 为每次掷骰签发密码学安全、无偏的整数和一份公开回执。玩家可以核对数字。工作室不能悄悄“设定”骰子。

获取免费 API 密钥

每个密钥每个 UTC 日免费 10,000 次调用。需要更多？联系我们。

演示掷骰 · 骰子

客户

已经公开掷骰的游戏。

这些工作室在战斗、掉落或桌面掷骰时调用 RandomDice.org。点击任一标志，打开该游戏的公开掷骰记录：最近 15 分钟的结果、必填的 player_name、参数和时间。在该页搜索你的昵称。游戏显示的数字若与记录不同，就没有使用我们的结果。

Rento 的公开掷骰 Ludo 的公开掷骰 Backgammon 的公开掷骰 Rento 的公开掷骰 Ludo 的公开掷骰 Backgammon 的公开掷骰

用途

玩家不必信任庄家的随机数。

托管游戏里，服务器属于工作室。“随机”骰子可以被加权、重掷或事后替换。那是安排，不是掷骰。RandomDice.org 站在游戏之外：服务器向我们要一个数，我们用 PHP random_int()（CSPRNG）生成，并公布每个已列出游戏最近 15 分钟的掷骰，包括必填的 player_name，以便任何人核对数值。

  • 无偏范围。 从 min 到 max 的均匀整数，默认 1–6。
  • 公开掷骰。 每个已列出游戏最近 15 分钟的掷骰，任何人都可以查看：昵称、数值、参数和时间。点击客户标志并搜索你的昵称。
  • 公开回执。 每次调用还会返回 id 和 verify_url。
  • 免费额度。 每个密钥每个 UTC 日 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 请求也只计一次额度。

额度

每个 UTC 日 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 日 10,000 次开始。提交游戏时粘贴同一把密钥，首页标志才能打开你的公开掷骰记录。

验证码图片

提交

列出你的游戏并获得证书印章。

这不会挡住 API。它是已核验的客户目录和公开掷骰记录。粘贴上方生成的完整 API 密钥——批准后，首页上的标志可以点击，并打开最近 15 分钟、可按昵称筛选的掷骰。待审条目会留在队列里，直到我们通过邮件批准或拒绝。

必填。粘贴“API 密钥”里的完整密钥，而不是短前缀。我们保存的是与该密钥的关联，不是秘密本身。批准后，点击标志会显示最近 15 分钟的掷骰，并带玩家筛选。

验证码图片

联系

额度、合作，或某次掷骰的问题。

我们不在此页公布邮箱。提交表单后，我们会回复到你填写的地址。

验证码图片