🗼 Talaia — API unificada

GET/api/v1

Índex de descobriment: llista totes les fonts disponibles amb el seu resum, l'hora d'actualització i l'enllaç a les dades completes.

GET/api/v1/font/{id}

Dades completes d'una font (bombers, xema, sismes, plans, rius, salut, seguretat, rodalies, uv…). Resposta: {dades, resum, actualitzat}.

curl http://localhost:8420/api/v1/font/bombers

GET/api/estat?fonts=a,b

Totes les fonts de cop (o només les del filtre). És el que fa servir el tauler.

GET/api/events

Flux Server-Sent Events. Esdeveniments: font (una font s'ha actualitzat) i alerta (alerta nova del motor).

const es = new EventSource('http://localhost:8420/api/events');
es.addEventListener('alerta', e => console.log(JSON.parse(e.data)));

GET/api/vols

Tots els vols ADS-B sobre Catalunya ara mateix (refresc ~30 s).

POST/api/avis

Envia un avís ciutadà. Cos: {"text": "...", "lat": 41.5, "lon": 1.7}. El triatge (heurístiques + corroboració de sensors + Claude si hi ha clau) retorna {puntuacio, estat, senyals}.

POST/api/subscripcio

Genera un codi per rebre alertes d'una àrea per Telegram. Cos: {"nom": "Casa", "bbox": [w,s,e,n]} → {codi, enllac}.

GET/api/plaalfa?bbox=w,s,e,n

Risc d'incendi (Pla Alfa) dels municipis que intersequen l'àrea.

GET/api/radar-aemet

Darrera imatge del radar meteorològic (regional Barcelona, AEMET). Binari (imatge).