Dadi indipendenti per i giochi online
Tiri che nessuno sul server può truccare.
RandomDice.org emette interi imparziali e crittograficamente sicuri e una ricevuta pubblica per ogni tiro. I giocatori possono controllare il numero. Gli studi non possono “impostare” il dado in silenzio.
Gratis: 10,000 chiamate per giorno UTC e per chiave. Ne serve di più? Contattaci.
Clienti
Giochi che tirano già allo scoperto.
Questi studi chiamano RandomDice.org per combattimento, bottino o tiri da tavolo. Clicca un logo per aprire il registro pubblico di quel gioco: tiri degli ultimi 15 minuti, player_name obbligatorio, parametri e orari. Cerca il tuo nickname in quella pagina. Un gioco che mostra un numero diverso dal registro non usa il nostro risultato.
Scopo
I giocatori non dovrebbero fidarsi dell’RNG della casa.
In un gioco ospitato, lo studio possiede il server. Un dado “casuale” può essere pesato, ritirato o sostituito dopo. Quello è un trucco, non un tiro. RandomDice.org sta fuori dal gioco: il server ci chiede un numero, lo generiamo con PHP random_int() (un CSPRNG) e pubblichiamo i tiri degli ultimi 15 minuti di ogni gioco in elenco, incluso il player_name obbligatorio, così chiunque può controllare il valore.
- Intervallo imparziale. Interi uniformi da
minamax, predefinito 1–6. - Tiri pubblici. Chiunque può vedere i tiri degli ultimi 15 minuti di ogni gioco in elenco: nickname, valori, parametri e orari. Clicca un logo e cerca il tuo nickname.
- Ricevuta pubblica. Ogni chiamata restituisce anche un
ide unaverify_url. - Quota gratuita. 10,000 chiamate API per giorno UTC e per chiave. Oltre, contattaci.
Come si usa
Una API JSON. Chiamala da qualsiasi cosa.
Funziona dalla barra degli indirizzi, da curl, fetch, Python, Java, HTTP di Godot, Unity e backend più vecchi che inviano JSON: qualsiasi cosa raggiunga HTTPS. Autenticati con un token Bearer, X-Api-Key o il parametro api_key.
Endpoint
GET or POST https://randomdice.org/api/v1/roll
Parametri
player_name (obbligatorio, 1–40 caratteri), min (predefinito 1), max (predefinito 6), count (1–100, predefinito 1). Autenticazione con Authorization: Bearer, X-Api-Key o api_key (comodo per un GET nel browser). Parametri di testo facoltativi: campi extra o un oggetto params — al massimo 10, chiavi e valori di al massimo 32 caratteri. Vengono salvati e mostrati nel registro pubblico. Le chiamate senza player_name sono rifiutate. Una richiesta HTTP conta come una chiamata di quota anche se count è un lotto.
Quota
10,000 chiamate per giorno UTC. Intestazioni: X-RateLimit-Limit, Remaining, Reset. Oltre la quota la risposta è 429.
GET nel browser — incolla nella barra degli indirizzi: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())
Una risposta riuscita include player_name, params, values, id, verify_url e (quando il gioco è in elenco) public_log_url. Mostra quei link ai giocatori. I tiri degli ultimi 15 minuti sono pubblici sulla pagina del gioco e cercabili per nickname, inclusi i parametri personalizzati. Gli errori sono JSON: { "ok": false, "error": { "code", "message" } }.
Chiave API
Emetti una chiave in un passo.
Nessuna attesa di approvazione. La chiave compare una volta in questa pagina e ti viene inviata per e-mail. La quota parte da 10,000 chiamate per giorno UTC. Incollerai la stessa chiave quando invii il gioco, così il logo in home apre il registro pubblico.
Invia
Elenca il tuo gioco e ottieni un timbro di certificato.
Questo non blocca l’API. È l’elenco verificato dei clienti e il registro pubblico. Incolla la chiave API completa generata sopra: dopo l’approvazione il logo in home è cliccabile e apre i tiri degli ultimi 15 minuti, filtrabili per nickname. Le schede in attesa restano in coda finché non le approviamo o rifiutiamo per e-mail.
Contatto
Quota, collaborazioni o un problema con un tiro.
Non pubblichiamo una casella su questa pagina. Invia il modulo e risponderemo all’indirizzo che indichi.