🗼 Talaia — API unificada

Totes les dades agregades pel servidor, servides en JSON des d'un sol lloc. Sense autenticació dins la xarxa local. Índex de descobriment automàtic a /api/v1.

Estat i fonts

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}.

Incendis i satèl·lit: effisba (perímetres de zones cremades EFFIS/Copernicus, amb hectàrees i municipi), copernicus (activacions Copernicus EMS a Espanya — incendis, inundacions, tempestes, sismes — amb perímetres), meteosat (foc actiu geoestacionari cada 15 min), firms (focus tèrmics VIIRS).
Aigua i previsió: glofas (previsió de cabal a 5 dies, ensemble ECMWF), previsio (pluja prevista i probabilitat), ebre/rius (nivells i cabals SAIH+ACA), embassaments.
Avisos: avisosCap (avisos meteo d'AEMET amb el polígon exacte de la zona), smp (Meteocat), sismesIgn (sismes IGN oficials).

curl https://talaiacat.dedyn.io/api/v1/font/effisba
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/historic?hores=24

Sèrie horària de mètriques agregades (focs, temperatura màx/mín, ratxa, pluja, embassaments, cabal de l'Ebre, sismes, trànsit, aire, energia i preus, NAA…) més sèries per estació: xe (XEMA: temp, pluja 90 min, ratxa), ai (qualitat de l'aire), eb (nivells i cabals SAIH-CHE) i em (embassaments). Paràmetres: ?hores=N (màx 168), ?series=0 (sense sèries per estació, molt més lleuger) o ?mes=YYYY-MM (un mes sencer, sempre sense sèries).

curl 'https://talaiacat.dedyn.io/api/historic?hores=48&series=0'

Temps real

GET/api/events

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

const es = new EventSource('https://talaiacat.dedyn.io/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).

Interacció

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).

Dades agregades de fonts públiques (vegeu «Fonts» al tauler). Informació orientativa: en emergència, truqueu al 112. Si exposeu aquesta API fora de la xarxa local, poseu-hi un proxy amb HTTPS i autenticació al davant.