Resumen
Quantum Random Bot Business API da acceso a aleatoriedad verificable y flujos de sorteos sin un proceso manual en Telegram.
Cada resultado importante puede vincularse a un Certificate ID público, una URL de verificación y un certificado PDF para participantes, legales, sponsors o auditoría interna.
Autorización
Cada solicitud requiere el encabezado Authorization: Bearer <key>. La clave se crea en el bot con el plan Business.
La clave en texto plano se muestra una sola vez. Guárdala como secreto y no la envíes al navegador del cliente.
Authorization: Bearer qrng_xxxxxxxxxxxxxxxxx
Random endpoints
GET /api/v1/me información de la clave +
Devuelve el plan, los límites y el uso de la clave API actual.
{
"plan": "business",
"key_prefix": "qrng_J5b8aB",
"requests_today": 42,
"daily_limit": 1000
}
GET /api/v1/random/int entero sin modulo bias +
Genera uno o varios enteros en un rango, sin 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 selección de una lista +
Selecciona uno o varios elementos de una lista.
{
"items": ["Alice", "Bob", "Charlie"],
"count": 1
}
{
"chosen": ["Bob"],
"source": "nist",
"request_id": "..."
}
POST /api/v1/random/shuffle mezcla Fisher-Yates +
Mezcla un arreglo con Fisher-Yates y una fuente cuántica.
{
"items": ["A", "B", "C", "D"]
}
GET /api/v1/random/bytes bytes aleatorios +
Devuelve bytes hex para tokens y claves: entropía segura del sistema con quantum-mix cuando hay una fuente externa disponible.
{
"hex": "3f9a2b8c...",
"bytes_count": 32,
"source": "anu",
"request_id": "..."
}
Giveaway endpoints
GET /api/v1/giveaways crear y listar sorteos +
Devuelve o crea sorteos vinculados al usuario o a la clave API.
{
"giveaways": [
{
"public_id": "A1B2C3D4",
"title": "My Giveaway",
"status": "active",
"participants_count": 500
}
],
"total": 1
}
POST /api/v1/giveaways crear y listar sorteos +
Devuelve o crea sorteos vinculados al usuario o a la clave API.
{
"title": "My API Giveaway",
"winners_count": 3,
"description": "Optional campaign copy"
}
POST /api/v1/giveaways/{id}/draw selección de ganadores +
Ejecuta la selección de ganadores y devuelve datos para verificación pública.
{
"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 exportación CSV +
Reporte CSV para sponsors, legales, contabilidad y auditoría interna.
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
Verificación y confianza
Verify URL público
Los participantes abren la página del certificado y ven fuente, algoritmo, hash y ganadores.
Audit trail
Business recibe datos suficientes para reportes y revisión interna.
Cascada de resiliencia
Si una fuente externa no responde, la solicitud pasa al siguiente nivel y la fuente usada queda registrada.
Errores
401 — clave ausente o inválida.
403 — el plan no incluye Business API.
429 — límite diario agotado.
500 — error temporal del servicio. Reintenta con backoff.
¿Listo para conectar aleatoriedad verificable?
Empieza con Business, crea una clave en el bot y conecta el API a tu campaña, CRM o producto.