# SIATA completo: diez endpoints para el Valle de Aburrá

**Publicado:** 27 de agosto de 2026 | **Autores:** Cristian Correa

---

Hasta hoy la API respondía por SIATA con un solo endpoint: clima, lluvia y PM2.5 de cada estación del Valle de Aburrá. Desde hoy la fuente `siata-geoportal` cubre todo lo que publica el sistema de alerta temprana de Medellín, en diez endpoints bajo `/co/siata-geoportal`.

| Endpoint | Qué devuelve |
| --- | --- |
| `/co/siata-geoportal/weather/v1` | Temperatura, humedad, viento y presión por estación, con serie horaria de 12 horas e índice UV |
| `/co/siata-geoportal/weather-series/v1` | Una estación minuto a minuto: temperatura, humedad, viento y presión en la última hora, o cada cinco minutos en las últimas seis |
| `/co/siata-geoportal/river-levels/v1` | Nivel de ríos, quebradas y alcantarillados con umbrales de inundación, estado, semáforo de alerta, ventanas y morfología de la cuenca |
| `/co/siata-geoportal/rainfall/v1` | Lluvia acumulada en siete ventanas (5 minutos a 30 días), totales mensuales y si está lloviendo ahora |
| `/co/siata-geoportal/air-quality/v1` | PM2.5, PM10, ozono, NO2, SO2 y CO por estación, cada uno con concentración, índice ICA numérico y categoría |
| `/co/siata-geoportal/citizen-sensors/v1` | La red ciudadana de sensores de PM2.5, unos 230 sensores de bajo costo |
| `/co/siata-geoportal/forecast/v1` | Pronóstico a dos días por municipio: temperaturas máxima y mínima y probabilidad de lluvia por franja del día |
| `/co/siata-geoportal/alerts/v1` | Avisos oficiales del sistema de alerta temprana |
| `/co/siata-geoportal/seismic-events/v1` | Últimos sismos registrados por acelerógrafos y sismógrafos, con magnitud, epicentro y lo que midió cada estación |
| `/co/siata-geoportal/cameras/v1` | Unas 90 cámaras con la URL de su última imagen |

Todos los endpoints de estaciones aceptan los mismos filtros opcionales: `latitude` y `longitude` con `radius_km` para las estaciones cercanas, ordenadas de la más cercana a la más lejana, y `municipality` o `station_code` para acotar. Un body vacío devuelve el valle completo.

## Niveles de ríos con umbrales

Cada estación de nivel trae ahora los umbrales de inundación de la fuente y un `status` derivado de ellos, así que no hace falta interpretar el nivel a mano.

```bash
curl https://api.croma.run/co/siata-geoportal/river-levels/v1 \
  -H "Authorization: Bearer $CROMA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "station_code": "520"
  }'
```

La respuesta incluye `level_m`, `thresholds` (`safe_m`, `caution_m`, `minor_flood_m`, `major_flood_m`), `status` (`normal`, `elevated`, `caution`, `minor_flood`, `major_flood`), el nivel máximo y medio de las últimas tres horas y, con `include_series: true`, una lectura por minuto de esas tres horas.

## Calidad del aire con índice ICA

`air-quality` pasa de un contaminante a seis, y cada lectura trae la concentración, el índice ICA numérico y su categoría (`Buena`, `Moderada`, `Dañina a la salud de grupos sensibles`, ...), además del contaminante que domina el índice de la estación.

## Qué cambia para quien usa el endpoint anterior

`POST /co/siata/v1` queda obsoleto desde el 27 de agosto de 2026 y dejará de responder el 1 de diciembre de 2026. Hasta entonces sigue funcionando igual y cada respuesta lleva las cabeceras `Deprecation`, `Sunset` y un `Link` con `rel="successor-version"`, como describe la [política de versionado](https://docs.usecroma.com/versioning).

Para migrar:

- Clima (`meteorology`): `POST /co/siata-geoportal/weather/v1`, mismos campos por estación más la serie de 12 horas.
- Lluvia (`rain`): `POST /co/siata-geoportal/rainfall/v1`. `accumulated_mm` ahora es un objeto con siete ventanas; `intensity_mm_h` no tiene equivalente.
- Calidad del aire (`air_quality`): `POST /co/siata-geoportal/air-quality/v1`. `pm25` e `air_quality_index` pasan a `pm25.concentration` y `pm25.index`.

Las respuestas de esta fuente se guardan en caché durante un minuto. La guía completa está en [SIATA Geoportal](https://docs.usecroma.com/guides/colombia/siata-geoportal) y la ficha de la fuente en [SIATA](/co/fuentes/siata).

---

**Más novedades:** [Ver todas las entradas del changelog](/es/changelog/sitemap.md) | [Croma](https://usecroma.com)