Nezávislé kostky pro online hry
Hody, které na serveru nikdo nepřekroutí.
RandomDice.org vydává kryptograficky bezpečná, nestranná celá čísla a veřejnou stvrzenku ke každému hodu. Hráči si číslo ověří. Studia kostku potichu „nenastaví“.
Zdarma 10,000 volání za UTC den a klíč. Potřebujete víc? Napište nám.
Klienti
Hry, které už házejí veřejně.
Tato studia volají RandomDice.org při boji, kořisti nebo stolních hodech. Klikněte na logo a otevřete veřejný záznam hodů té hry — hody za posledních 15 minut, povinné player_name, parametry a časy. Na stránce vyhledejte svou přezdívku. Hra, která ukáže jiné číslo než záznam, náš výsledek nepoužívá.
Účel
Hráči by neměli muset věřit RNG domu.
U hostované hry vlastní server studio. „Náhodná“ kostka může být vážená, přehozená nebo dodatečně vyměněná. To je dohoda, ne hod. RandomDice.org stojí mimo hru: server si řekne o číslo, vygenerujeme ho přes PHP random_int() (CSPRNG) a zveřejníme hody za posledních 15 minut každé uvedené hry — včetně povinného player_name — aby si hodnotu mohl kdokoli ověřit.
- Nestranný rozsah. Rovnoměrná celá čísla od
mindomax, výchozí 1–6. - Veřejné hody. Hody za posledních 15 minut každé uvedené hry vidí kdokoli — přezdívka, hodnoty, parametry a časy. Klikněte na logo a vyhledejte svou přezdívku.
- Veřejná stvrzenka. Každé volání vrací také
idaverify_url. - Bezplatná kvóta. 10,000 volání API za UTC den a klíč. Nad to nám napište.
Jak používat
Jedno JSON API. Volejte ho odkudkoli.
Funguje z adresního řádku, curl, fetch, Pythonu, Javy, HTTP Godot, Unity i starších backendů, které umí poslat JSON — z čehokoli, co dosáhne na HTTPS. Ověřte se tokenem Bearer, hlavičkou X-Api-Key nebo parametrem api_key.
Endpoint
GET or POST https://randomdice.org/api/v1/roll
Parametry
player_name (povinné, 1–40 znaků), min (výchozí 1), max (výchozí 6), count (1–100, výchozí 1). Ověření přes Authorization: Bearer, X-Api-Key nebo api_key (hodí se pro GET v prohlížeči). Volitelné vlastní řetězce: další pole nebo objekt params — nejvýš 10, klíče a hodnoty nejvýš 32 znaků. Uloží se a ukážou ve veřejném záznamu. Volání bez player_name se odmítnou. Jeden HTTP požadavek se počítá jako jedno volání kvóty i když je count dávka.
Kvóta
10,000 volání za UTC den. Hlavičky: X-RateLimit-Limit, Remaining, Reset. Nad kvótu přijde 429.
GET v prohlížeči — vložte do adresního řádku: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())
Úspěšná odpověď obsahuje player_name, params, values, id, verify_url a (jakmile je hra uvedena) public_log_url. Ty odkazy ukažte hráčům. Hody za posledních 15 minut jsou na stránce hry veřejné a jdou hledat podle přezdívky, včetně vlastních parametrů. Chyby jsou JSON: { "ok": false, "error": { "code", "message" } }.
Klíč API
Vydat klíč v jednom kroku.
Bez čekání na schválení. Klíč se ukáže jednou na této stránce a přijde e-mailem. Kvóta začíná na 10,000 voláních za UTC den. Stejný klíč vložíte při odeslání hry, aby logo na úvodní stránce otevřelo veřejný záznam hodů.
Odeslat
Uveďte hru a získejte certifikační razítko.
Tím se API nezamyká. Je to ověřený adresář klientů a veřejný záznam hodů. Vložte celý klíč API z výše — po schválení je logo na úvodní stránce klikací a otevře hody za posledních 15 minut, filtrovatelné podle přezdívky. Čekající záznamy zůstanou ve frontě, dokud je e-mailem neschválíme nebo neodmítneme.
Kontakt
Kvóta, spolupráce nebo problém s hodem.
Na této stránce schránku nezveřejňujeme. Pošlete formulář a odpovíme na uvedenou adresu.