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.

Tiro demo · dado

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 min a max, 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 id e una verify_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.

Immagine captcha

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.

Obbligatoria. Incolla la chiave completa da “Chiave API”, non il prefisso corto. Conserviamo un collegamento a quella chiave, non il segreto. Dopo l’approvazione, un clic sul logo mostra i tiri degli ultimi 15 minuti con filtro sul giocatore.

Immagine captcha

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.

Immagine captcha