Endpoints HTTP API

GET /raw

Retorna um buffer binário de bytes aleatórios do pool central de entropia. Tamanho padrão: 64 KB; parâmetro `bytes` de 1 a 1.048.576 B.

curl -s "https://entropy.sparksome.pl/raw?bytes=32" | xxd -p

GET /raw/stream

Streaming contínuo de bytes aleatórios binários por socket HTTP aberto. Útil para serviços com alta demanda de entropia.

curl -N -s "https://entropy.sparksome.pl/raw/stream?bytes=65536" > entropy_stream.bin

GET /download/entropy

Retorna um arquivo `.bin` com cabeçalho `Content-Disposition: attachment` para downloads por navegador ou scripts.

GET /healthz

Retorna o estado operacional do nó em JSON: pool disponível, estado SDR, rejeições e tempos de resposta.

Exemplos de integração

> Python (requests / urllib)

import requests

response = requests.get("https://entropy.sparksome.pl/raw", params={"bytes": 64})
if response.status_code == 200:
    random_bytes = response.content
    print("Pobrano bytes:", random_bytes.hex())

> JavaScript (Node.js fetch)

const res = await fetch("https://entropy.sparksome.pl/raw?bytes=32");
const buffer = await res.arrayBuffer();
const bytes = new Uint8Array(buffer);
console.log("Random Bytes:", bytes);

> Shell / cURL

# Fetch 16 random bytes as hex
curl -s "https://entropy.sparksome.pl/raw?bytes=16" | xxd -p

Limites e proteção contra sobrecarga

Para evitar esgotar o pool de entropia, o Nginx aplica rate limiting. Endpoints padrão permitem 10 req/s; downloads /raw mais pesados ficam em 2-3 req/s por IP.

HTTP 429 Too Many Requests — w przypadku przekroczenia limitu odczekaj zadaną liczbę sekund podaną w nagłówku Retry-After.