Niezależne kości do gier online

Rzuty, których nikt na serwerze nie podmieni.

RandomDice.org wydaje kryptograficznie bezpieczne, nieobciążone liczby całkowite i publiczne pokwitowanie każdego rzutu. Gracze mogą sprawdzić liczbę. Studia nie mogą po cichu „ustawić” kości.

Weź darmowy klucz API

Za darmo 10,000 wywołań na dobę UTC na klucz. Potrzebujesz więcej? Napisz do nas.

Rzut demo · kość

Klienci

Gry, które już rzucają jawnie.

Te studia wołają RandomDice.org przy walce, łupie albo rzutach stołowych. Kliknij logo, aby otworzyć publiczny dziennik rzutów tej gry — rzuty z ostatnich 15 minut, wymagane player_name, parametry i znaczniki czasu. Wyszukaj swój nick na tej stronie. Gra, która pokazuje inną liczbę niż dziennik, nie używa naszego wyniku.

Cel

Gracze nie powinni musieć ufać RNG domu.

W grze hostowanej serwer należy do studia. „Losowa” kość może być ważona, przerzucona albo podmieniona po fakcie. To ustawka, nie rzut. RandomDice.org stoi poza grą: serwer prosi nas o liczbę, generujemy ją przez PHP random_int() (CSPRNG) i publikujemy rzuty z ostatnich 15 minut każdej wymienionej gry — razem z wymaganym player_name — żeby każdy mógł sprawdzić wartość.

  • Nieobciążony zakres. Jednostajne liczby całkowite od min do max, domyślnie 1–6.
  • Publiczne rzuty. Rzuty z ostatnich 15 minut każdej wymienionej gry widzi każdy — nick, wartości, parametry i czas. Kliknij logo klienta i wyszukaj swój nick.
  • Publiczne pokwitowanie. Każde wywołanie zwraca też id i verify_url.
  • Darmowy limit. 10,000 wywołań API na dobę UTC na klucz. Powyżej napisz do nas.

Jak używać

Jedno API JSON. Wołaj je skądkolwiek.

Działa z paska adresu, curl, fetch, Pythona, Javy, HTTP Godot, Unity i starszych backendów, które wyślą JSON — z czegokolwiek, co sięgnie HTTPS. Uwierzytelnij się tokenem Bearer, nagłówkiem X-Api-Key albo parametrem api_key.

Endpoint

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

Parametry

player_name (wymagane, 1–40 znaków), min (domyślnie 1), max (domyślnie 6), count (1–100, domyślnie 1). Uwierzytelnienie przez Authorization: Bearer, X-Api-Key albo api_key (wygodne przy GET w przeglądarce). Opcjonalne własne napisy: dodatkowe pola albo obiekt params — najwyżej 10, klucze i wartości do 32 znaków. Są zapisywane i pokazane w publicznym dzienniku. Wywołania bez player_name są odrzucane. Jedno żądanie HTTP liczy się jako jedno wywołanie limitu, nawet gdy count to paczka.

Limit

10,000 wywołań na dobę UTC. Nagłówki: X-RateLimit-Limit, Remaining, Reset. Po przekroczeniu odpowiedź to 429.

GET w przeglądarce — wklej w pasek adresu: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())

Udany wynik zawiera player_name, params, values, id, verify_url oraz (gdy gra jest na liście) public_log_url. Pokaż te linki graczom. Rzuty z ostatnich 15 minut są publiczne na stronie gry i da się je szukać po nicku, razem z własnymi parametrami. Błędy to JSON: { "ok": false, "error": { "code", "message" } }.

Klucz API

Wydaj klucz w jednym kroku.

Bez czekania na akceptację. Klucz pokazujemy raz na tej stronie i wysyłamy e-mailem. Limit zaczyna się od 10,000 wywołań na dobę UTC. Ten sam klucz wkleisz przy zgłoszeniu gry, żeby logo na stronie głównej otwierało publiczny dziennik rzutów.

Obraz captcha

Zgłoś

Wpisz grę i odbierz pieczęć certyfikatu.

To nie blokuje API. To zweryfikowany katalog klientów i publiczny dziennik rzutów. Wklej pełny klucz API wygenerowany wyżej — po akceptacji logo na stronie głównej da się kliknąć i otworzy rzuty z ostatnich 15 minut, z filtrem nicku. Oczekujące zgłoszenia czekają w kolejce, aż zaakceptujemy je albo odrzucimy e-mailem.

Wymagany. Wklej pełny klucz z „Klucz API”, nie krótki prefiks. Zapisujemy powiązanie z tym kluczem, nie sam sekret. Po akceptacji kliknięcie logo pokazuje rzuty z ostatnich 15 minut z filtrem gracza.

Obraz captcha

Kontakt

Limit, współpraca albo problem z rzutem.

Nie publikujemy skrzynki na tej stronie. Wyślij formularz, odpowiemy na podany adres.

Obraz captcha