Çevrimiçi oyunlar için bağımsız zar

Sunucudaki kimsenin ayarlayamayacağı atışlar.

RandomDice.org her atış için kriptografik olarak güvenli, tarafsız tamsayılar ve herkese açık bir makbuz verir. Oyuncular sayıyı kontrol edebilir. Stüdyolar zarı sessizce “ayarlayamaz”.

Ücretsiz API anahtarı al

Anahtar başına UTC gününde 10,000 çağrı ücretsiz. Daha fazlası mı lazım? Bize yazın.

Deneme atışı · zar

İstemciler

Zaten açıkta atan oyunlar.

Bu stüdyolar savaş, ganimet veya masa atışları için RandomDice.org’u çağırır. Oyunun herkese açık atış günlüğünü açmak için bir logoya tıklayın — son 15 dakikanın atışları, zorunlu player_name, parametreler ve zaman damgaları. O sayfada takma adınızı arayın. Günlükten farklı bir sayı gösteren oyun bizim sonucumuzu kullanmıyordur.

Rento herkese açık atışlar Ludo herkese açık atışlar Backgammon herkese açık atışlar Rento herkese açık atışlar Ludo herkese açık atışlar Backgammon herkese açık atışlar

Amaç

Oyuncular evin rastgele sayı üretecine güvenmek zorunda kalmamalı.

Barındırılan bir oyunda sunucu stüdyonundur. “Rastgele” bir zar ağırlıklı olabilir, yeniden atılabilir veya sonradan değiştirilebilir. Bu bir kurgu, atış değil. RandomDice.org oyunun dışındadır: sunucu bizden bir sayı ister, biz onu PHP random_int() ile (bir CSPRNG) üretiriz ve listelenen her oyunun son 15 dakikalık atışlarını — zorunlu player_name dahil — herkesin değeri kontrol edebilmesi için yayımlarız.

  • Tarafsız aralık. min ile max arasında düzgün tamsayılar, varsayılan 1–6.
  • Herkese açık atışlar. Listelenen her oyunun son 15 dakikalık atışlarını herkes görebilir — takma ad, değerler, parametreler ve zaman. Bir istemci logosuna tıklayıp takma adınızı arayın.
  • Herkese açık makbuz. Her çağrı ayrıca bir id ve verify_url döndürür.
  • Ücretsiz kota. Anahtar başına UTC gününde 10,000 API çağrısı. Bunun üstü için bize yazın.

Nasıl kullanılır

Tek bir JSON API. Her yerden çağırın.

Adres çubuğundan, curl, fetch, Python, Java, Godot HTTP, Unity ve JSON gönderebilen eski arka uçlardan çalışır — HTTPS’e ulaşan her şeyden. Bearer belirteci, X-Api-Key veya api_key parametresiyle kimlik doğrulayın.

Uç nokta

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

Parametreler

player_name (zorunlu, 1–40 karakter), min (varsayılan 1), max (varsayılan 6), count (1–100, varsayılan 1). Authorization: Bearer, X-Api-Key veya api_key ile kimlik doğrulama (tarayıcıda GET için elverişli). İsteğe bağlı özel dizeler: ek alanlar veya bir params nesnesi — en fazla 10, anahtar ve değerler en fazla 32 karakter. Saklanır ve herkese açık günlükte gösterilir. player_name olmayan çağrılar reddedilir. count bir yığın olsa bile bir HTTP isteği bir kota çağrısı sayılır.

Kota

UTC gününde 10,000 çağrı. Üst bilgiler: X-RateLimit-Limit, Remaining, Reset. Kotanın üstünde yanıt 429 olur.

Tarayıcı GET — adres çubuğuna yapıştırın: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())

Başarılı yanıt player_name, params, values, id, verify_url ve (oyun listelenince) public_log_url içerir. Bu bağlantıları oyunculara gösterin. Son 15 dakikanın atışları oyun sayfasında herkese açıktır ve özel parametreler dahil takma ada göre aranabilir. Hatalar JSON’dur: { "ok": false, "error": { "code", "message" } }.

API anahtarı

Anahtarı tek adımda alın.

Onay beklemezsiniz. Anahtar bu sayfada bir kez gösterilir ve size e-posta ile gönderilir. Kota, UTC gününde 10,000 çağrıdan başlar. Ana sayfadaki logonun herkese açık atış günlüğünüzü açması için oyununuzu gönderirken aynı anahtarı yapıştırırsınız.

Captcha görseli

Gönder

Oyununuzu listeleyin ve bir sertifika mührü alın.

Bu, API’yi kilitlemez. Doğrulanmış istemci dizini ve herkese açık atış günlüğüdür. Yukarıda ürettiğiniz tam API anahtarını yapıştırın — onaydan sonra ana sayfadaki logonuz tıklanabilir olur ve takma ada göre süzülebilen son 15 dakikanın atışlarını açar. Bekleyen kayıtlar, e-posta ile onaylayana veya reddedene kadar kuyrukta kalır.

Zorunlu. “API anahtarı” bölümündeki tam anahtarı yapıştırın, kısa öneki değil. Sırrı değil, o anahtara bir bağ saklarız. Onaydan sonra logonuza tıklamak, oyuncu süzgeciyle son 15 dakikanın atışlarını gösterir.

Captcha görseli

İletişim

Kota, ortaklık veya bir atış sorunu.

Bu sayfada bir posta kutusu yayımlamayız. Formu gönderin, yazdığınız adrese yanıt veririz.

Captcha görseli