Обзор
Quantum Random Bot Business API даёт доступ к проверяемой случайности и сценариям розыгрышей без ручного Telegram-flow.
Каждый важный результат может быть связан с публичным Certificate ID, verify URL и PDF-сертификатом для участников, юристов, спонсоров или внутреннего аудита.
Авторизация
Все запросы требуют заголовок Authorization: Bearer <key>. Ключ создаётся в боте на тарифе Business.
Plaintext ключ показывается только при создании. Храните его как секрет и не отправляйте в клиентский браузер.
Authorization: Bearer qrng_xxxxxxxxxxxxxxxxx
Random endpoints
GET /api/v1/me информация о ключе +
Возвращает план, лимиты и статистику текущего API-ключа.
{
"plan": "business",
"key_prefix": "qrng_J5b8aB",
"requests_today": 42,
"daily_limit": 1000
}
GET /api/v1/random/int случайное число без modulo bias +
Генерирует одно или несколько целых чисел в диапазоне. Диапазоны выбираются без modulo bias.
GET /api/v1/random/int?min=1&max=100&count=3
{
"numbers": [42, 7, 91],
"source": "anu",
"request_id": "c46bd22a-de82-466e-9571-8fc56d655b3e"
}
POST /api/v1/random/choice выбор из списка +
Выбирает один или несколько элементов из списка.
{
"items": ["Alice", "Bob", "Charlie"],
"count": 1
}
{
"chosen": ["Bob"],
"source": "nist",
"request_id": "..."
}
POST /api/v1/random/shuffle перемешивание Fisher-Yates +
Перемешивает массив через Fisher-Yates с квантовым источником случайности.
{
"items": ["A", "B", "C", "D"]
}
GET /api/v1/random/bytes случайные байты +
Возвращает hex-байты для токенов и ключей: секретная системная энтропия с quantum-mix при наличии внешнего источника.
{
"hex": "3f9a2b8c...",
"bytes_count": 32,
"source": "anu",
"request_id": "..."
}
Giveaway endpoints
GET /api/v1/giveaways создание и список розыгрышей +
Возвращает или создаёт розыгрыши, связанные с пользователем или API-ключом.
{
"giveaways": [
{
"public_id": "A1B2C3D4",
"title": "My Giveaway",
"status": "active",
"participants_count": 500
}
],
"total": 1
}
POST /api/v1/giveaways создание и список розыгрышей +
Возвращает или создаёт розыгрыши, связанные с пользователем или API-ключом.
{
"title": "My API Giveaway",
"winners_count": 3,
"description": "Optional campaign copy"
}
POST /api/v1/giveaways/{id}/draw выбор победителей +
Проводит выбор победителей и возвращает данные для публичной проверки.
{
"winners": [
{"username": "alice", "telegram_id": 123456}
],
"certificate_id": "17d58bb5...",
"verify_url": "https://quantum-bot.space/verify/17d58bb5...",
"qrng_source": "anu",
"request_id": "..."
}
GET /api/v1/giveaways/{id}/participants.csv CSV экспорт +
CSV-отчёт для спонсоров, юристов, бухгалтерии и внутреннего аудита.
telegram_id,username,first_name,joined_at,is_winner
123456,alice,Alice,2026-05-05T12:00:00,true
789012,bob,Bob,2026-05-05T12:05:00,false
Проверка и доверие
Публичный verify URL
Участник открывает страницу сертификата и видит источник случайности, алгоритм, hash и победителей.
Audit trail
Business получает данные, достаточные для отчёта и внутренней проверки результата.
Каскад устойчивости
Если один внешний источник недоступен, запрос переходит на следующий уровень, а использованный источник фиксируется.
Ошибки
401 — ключ отсутствует или неверный.
403 — тариф не поддерживает Business API.
429 — дневной лимит API исчерпан.
500 — временная ошибка сервиса. Повторите запрос с backoff.
Готовы подключить проверяемую случайность?
Начните с Business-плана, создайте ключ в боте и подключите API к вашей кампании, CRM или продукту.