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.
Za darmo 10,000 wywołań na dobę UTC na klucz. Potrzebujesz więcej? Napisz do nas.
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
mindomax, 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ż
idiverify_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.
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.
Kontakt
Limit, współpraca albo problem z rzutem.
Nie publikujemy skrzynki na tej stronie. Wyślij formularz, odpowiemy na podany adres.