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.

Ukázkový hod · kostka

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 min do max, 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é id a verify_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ů.

Obrázek captcha

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.

Povinné. Vložte celý klíč z „Klíč API“, ne krátkou předponu. Ukládáme vazbu na ten klíč, ne tajemství. Po schválení klik na logo ukáže hody za posledních 15 minut s filtrem hráče.

Obrázek captcha

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.

Obrázek captcha