Незалежні кості для онлайн-ігор

Кидки, які ніхто на сервері не підтасує.

RandomDice.org видає криптографічно стійкі неупереджені цілі числа і публічну квитанцію на кожен кидок. Гравці можуть звірити число. Студії не можуть тихо «виставити» кість.

Отримати безкоштовний ключ API

Безкоштовно 10,000 викликів на добу UTC на ключ. Потрібно більше? Напишіть нам.

Демо-кидок · кість

Клієнти

Ігри, які вже кидають відкрито.

Ці студії викликають RandomDice.org для бою, здобичі чи настільних кидків. Натисніть логотип, щоб відкрити публічний журнал цієї гри — кидки за останні 15 хвилин, обов’язкове player_name, параметри й час. Знайдіть свій нік на тій сторінці. Гра, яка показує інше число, ніж журнал, не використовує наш результат.

Публічні кидки Rento Публічні кидки Ludo Публічні кидки Backgammon Публічні кидки Rento Публічні кидки Ludo Публічні кидки Backgammon

Навіщо

Гравцям не слід довіряти генератору випадкових чисел дому.

У розміщеній грі сервер належить студії. «Випадкова» кість може бути зважена, перекинута або підмінена заднім числом. Це підтасовка, а не кидок. 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, HTTP Godot, 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 хвилин із фільтром гравця.

Зображення капчі

Контакт

Квота, співпраця або проблема з кидком.

Ми не публікуємо скриньку на цій сторінці. Надішліть форму, і ми відповімо на вказану адресу.

Зображення капчі