Dados independentes para jogos online

Rolagens que ninguém no servidor consegue viciar.

O RandomDice.org emite inteiros imparciais e criptograficamente seguros e um recibo público para cada rolagem. Os jogadores podem conferir o número. Os estúdios não conseguem “fixar” o dado em silêncio.

Obter uma chave API grátis

Grátis: 10,000 chamadas por dia UTC e por chave. Precisa de mais? Contacte-nos.

Rolagem de demonstração · dado

Clientes

Jogos que já rolam à vista.

Estes estúdios chamam o RandomDice.org para combate, saque ou rolagens de mesa. Clique num logo para abrir o registo público desse jogo — rolagens dos últimos 15 minutos, o player_name obrigatório, parâmetros e marcas de tempo. Procure a sua alcunha nessa página. Um jogo que mostre um número diferente do registo não está a usar o nosso resultado.

Rolagens públicas de Rento Rolagens públicas de Ludo Rolagens públicas de Backgammon Rolagens públicas de Rento Rolagens públicas de Ludo Rolagens públicas de Backgammon

Objetivo

Os jogadores não deviam ter de confiar no RNG da casa.

Num jogo alojado, o estúdio é dono do servidor. Um dado “aleatório” pode ser ponderado, repetido ou trocado depois. Isso é uma montagem, não uma rolagem. O RandomDice.org fica fora do jogo: o servidor pede-nos um número, geramo-lo com PHP random_int() (um CSPRNG) e publicamos as rolagens dos últimos 15 minutos de cada jogo listado — incluindo o player_name obrigatório — para qualquer pessoa conferir o valor.

  • Intervalo imparcial. Inteiros uniformes de min a max, por omissão 1–6.
  • Rolagens públicas. Qualquer pessoa pode ver as rolagens dos últimos 15 minutos de cada jogo listado — alcunha, valores, parâmetros e marcas de tempo. Clique num logo e procure a sua alcunha.
  • Recibo público. Cada chamada também devolve um id e um verify_url.
  • Quota gratuita. 10,000 chamadas à API por dia UTC e por chave. Acima disso, contacte-nos.

Como usar

Uma API JSON. Chame-a de qualquer sítio.

Funciona a partir da barra de endereços, curl, fetch, Python, Java, HTTP do Godot, Unity e backends antigos que enviem JSON — tudo o que chegue a HTTPS. Autentique-se com um token Bearer, X-Api-Key ou o parâmetro api_key.

Endpoint

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

Parâmetros

player_name (obrigatório, 1–40 caracteres), min (omissão 1), max (omissão 6), count (1–100, omissão 1). Autenticação com Authorization: Bearer, X-Api-Key ou api_key (útil para um GET no browser). Parâmetros de texto opcionais: campos extra ou um objeto params — no máximo 10, chaves e valores com no máximo 32 caracteres. São guardados e mostrados no registo público. Chamadas sem player_name são rejeitadas. Um pedido HTTP conta como uma chamada de quota mesmo quando count é um lote.

Quota

10,000 chamadas por dia UTC. Cabeçalhos: X-RateLimit-Limit, Remaining, Reset. Acima da quota a resposta é 429.

GET no browser — cole na barra de endereços: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())

Uma resposta de sucesso inclui player_name, params, values, id, verify_url e (quando o jogo está listado) public_log_url. Mostre esses links aos jogadores. As rolagens dos últimos 15 minutos são públicas na página do jogo e pesquisáveis pela alcunha, incluindo parâmetros personalizados. Os erros são JSON: { "ok": false, "error": { "code", "message" } }.

Chave API

Emita uma chave num passo.

Sem espera de aprovação. A chave aparece uma vez nesta página e é enviada por e-mail. A quota começa em 10,000 chamadas por dia UTC. Vai colar a mesma chave ao enviar o jogo para o logo da página inicial abrir o registo público.

Imagem do captcha

Enviar

Liste o seu jogo e receba um selo de certificado.

Isto não bloqueia a API. É o diretório verificado de clientes e o registo público. Cole a chave API completa gerada acima — depois da aprovação, o logo na página inicial é clicável e abre as rolagens dos últimos 15 minutos, filtráveis pela alcunha. As fichas pendentes ficam na fila até aprovarmos ou recusarmos por e-mail.

Obrigatória. Cole a chave completa de “Chave API”, não o prefixo curto. Guardamos uma ligação a essa chave, não o segredo. Depois da aprovação, clicar no logo mostra as rolagens dos últimos 15 minutos com filtro de jogador.

Imagem do captcha

Contacto

Quota, parcerias ou um problema com uma rolagem.

Não publicamos uma caixa de correio nesta página. Envie o formulário e respondemos ao endereço que indicar.

Imagem do captcha