Публичный API HL Lava RNG предназначен для получения случайных байтов и “производных” представлений (цвета/строки/блоки). Данные выдаются криптографическим DRBG, который регулярно пересеивается физической энтропией (лавовые лампы).
Нажмите кнопку выше, чтобы выполнить запрос.
Проверка состояния генератора и основных подсистем. Используется страницами UI для индикаторов “OK/Warn/Error”.
{
"ok": true,
"status": {
"camera_ok": true,
"has_latest_colors": true,
"drbg_ok": true,
"bytes_served": 123456
}
}
Получение массива байтов (0..255). Это базовый эндпоинт — на нём построены hex/binary/blocks и большинство визуализаций.
length — число байт (1..N)/api/random/bytes?length=32{
"ok": true,
"bytes": [12, 255, 83, 0, 19, 44, 7, 231, ... ],
"length": 32
}
Получение списка цветов в формате #RRGGBB. Удобно для витрин/демо и “live colours”.
count — количество цветов (1..N)/api/random/colors?count=16{
"ok": true,
"colors": ["#2bb3ff", "#0b0f19", "#ff6b8b", ...],
"count": 16
}
Старый совместимый эндпоинт. Рекомендуется переходить на /api/random/bytes и /api/random/colors.
curl "http://127.0.0.1:8000/api/status" curl "http://127.0.0.1:8000/api/random/bytes?length=64" curl "http://127.0.0.1:8000/api/random/colors?count=16"
(Invoke-RestMethod "http://127.0.0.1:8000/api/status") (Invoke-RestMethod "http://127.0.0.1:8000/api/random/bytes?length=64") (Invoke-RestMethod "http://127.0.0.1:8000/api/random/colors?count=16")
const r = await fetch("/api/random/bytes?length=32");
const j = await r.json();
if (j.ok) {
const bytes = j.bytes; // [0..255]
console.log(bytes);
}
Публичный эндпоинт выдаёт байты как JSON-массив чисел. Это удобно для демо/обучения. Для высокой пропускной способности позже добавим бинарный режим (например, application/octet-stream) отдельным endpoint’ом или через параметр.
{
"ok": false,
"error": "bad_request",
"message": "length must be 1..1048576"
}
length, count).error=internal).Рекомендуемый лимит для /api/random/bytes — до 1 MiB за запрос. Для UI обычно достаточно 32–8192 байт.
Для публичного доступа разумно включать rate-limit. Если сервер начнёт тормозить, UI можно перевести на более редкие обновления (1–2 кадра/сек).
В случае проблем с камерой система может временно работать только на DRBG-пуле (без свежих кадров). Это отражается в /api/status.
Админ-управление и конфиг будут вынесены в отдельные /api/admin/* эндпоинты и закрыты токеном/сетевыми ACL. Публичный API не должен позволять управлять генератором.