Независими зарове за онлайн игри

Хвърляния, които никой на сървъра не може да нагласи.

RandomDice.org издава криптографски сигурни, безпристрастни цели числа и публична разписка за всяко хвърляне. Играчите могат да проверят числото. Студиата не могат тихо да „настроят“ зара.

Безплатно 10,000 заявки на UTC ден за ключ. Трябват повече? Пишете ни.

Демо хвърляне · зар

Клиенти

Игри, които вече хвърлят на открито.

Тези студиа викат RandomDice.org за бой, плячка или хвърляния на маса. Щракнете лого, за да отворите публичния дневник на тази игра — хвърляния от последните 15 минути, задължителното player_name, параметрите и времената. Потърсете прякора си на тази страница. Игра, която показва друго число от дневника, не ползва нашия резултат.

Цел

Играчите не бива да се доверяват на RNG-то на къщата.

При хоствана игра сървърът е на студиото. „Случаен“ зар може да е натежен, прехвърлен или сменен след факта. Това е нагласа, не хвърляне. RandomDice.org стои извън играта: сървърът ни иска число, генерираме го с PHP random_int() (CSPRNG) и публикуваме хвърлянията от последните 15 минути на всяка вписана игра — заедно със задължителното player_name — за да може всеки да провери стойността.

  • Безпристрастен диапазон. Равномерни цели числа от min до max, по подразбиране 1–6.
  • Публични хвърляния. Хвърлянията от последните 15 минути на всяка вписана игра се виждат от всеки — прякор, стойности, параметри и времена. Щракнете клиентско лого и потърсете прякора си.
  • Публична разписка. Всяка заявка връща и id, и verify_url.
  • Безплатна квота. 10,000 API заявки на UTC ден за ключ. Над това пишете ни.

Как се ползва

Един JSON API. Викайте го отвсякъде.

Работи от адресната лента, curl, fetch, Python, Java, Godot HTTP, Unity и по-стари бекенди, които пращат JSON — всичко, което стига до HTTPS. Удостоверявайте се с Bearer токен, X-Api-Key или параметър api_key.

Крайна точка

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

Параметри

player_name (задължително, 1–40 знака), min (по подразбиране 1), max (по подразбиране 6), count (1–100, по подразбиране 1). Удостоверяване с Authorization: Bearer, X-Api-Key или api_key (удобно за GET в браузъра). По желание собствени низове: допълнителни полета или обект params — най-много 10, ключове и стойности до 32 знака. Записват се и се показват в публичния дневник. Заявки без player_name се отказват. Една HTTP заявка брои за едно повикване на квотата дори когато count е партида.

Квота

10,000 заявки на UTC ден. Заглавки: X-RateLimit-Limit, Remaining, Reset. Над квотата отговорът е 429.

GET в браузъра — поставете в адресната лента: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())

Успешният отговор включва player_name, params, values, id, verify_url и (след като играта е вписана) public_log_url. Покажете тези връзки на играчите. Хвърлянията от последните 15 минути са публични на страницата на играта и се търсят по прякор, включително собствените параметри. Грешките са JSON: { "ok": false, "error": { "code", "message" } }.

API ключ

Издайте ключ на една стъпка.

Без чакане за одобрение. Ключът се показва веднъж на тази страница и се праща по имейл. Квотата започва от 10,000 заявки на UTC ден. Същия ключ ще поставите, когато изпратите играта, за да отваря логото на началната страница публичния дневник.

Картинка на капчата

Изпрати

Впишете играта и вземете сертификатен печат.

Това не спира API-то. Това е провереният каталог с клиенти и публичният дневник. Поставете пълния API ключ отгоре — след одобрение логото на началната страница се щраква и отваря хвърлянията от последните 15 минути, с филтър по прякор. Чакащите записи стоят на опашка, докато ги одобрим или откажем по имейл.

Задължително. Поставете пълния ключ от „API ключ“, не краткия префикс. Пазим връзка към този ключ, не тайната. След одобрение щракването на логото показва хвърлянията от последните 15 минути с филтър по играч.

Картинка на капчата

Контакт

Квота, партньорство или проблем с хвърляне.

Не публикуваме пощенска кутия на тази страница. Пратете формуляра и ще отговорим на посочения адрес.

Картинка на капчата