# SIATA completo: dez endpoints para o Vale de Aburrá

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

---

Até hoje, a API respondia pelo SIATA com um único endpoint: clima, chuva e PM2.5 de cada estação do Vale de Aburrá. A partir de hoje, a fonte `siata-geoportal` cobre tudo o que o sistema de alerta precoce de Medellín publica, em dez endpoints sob `/co/siata-geoportal`.

| Endpoint | O que devolve |
| --- | --- |
| `/co/siata-geoportal/weather/v1` | Temperatura, umidade, vento e pressão por estação, com série horária de 12 horas e índice UV |
| `/co/siata-geoportal/weather-series/v1` | Uma estação minuto a minuto: temperatura, umidade, vento e pressão na última hora, ou a cada cinco minutos nas últimas seis |
| `/co/siata-geoportal/river-levels/v1` | Nível de rios, córregos e galerias pluviais com limites de inundação, estado, semáforo de alerta, janelas e morfologia da bacia |
| `/co/siata-geoportal/rainfall/v1` | Chuva acumulada em sete janelas (5 minutos a 30 dias), totais mensais e se está chovendo agora |
| `/co/siata-geoportal/air-quality/v1` | PM2.5, PM10, ozônio, NO2, SO2 e CO por estação, cada um com concentração, índice ICA numérico e categoria |
| `/co/siata-geoportal/citizen-sensors/v1` | A rede cidadã de sensores de PM2.5, cerca de 230 sensores de baixo custo |
| `/co/siata-geoportal/forecast/v1` | Previsão para dois dias por município: temperaturas máxima e mínima e probabilidade de chuva por período do dia |
| `/co/siata-geoportal/alerts/v1` | Avisos oficiais do sistema de alerta precoce |
| `/co/siata-geoportal/seismic-events/v1` | Últimos sismos registrados por acelerógrafos e sismógrafos, com magnitude, epicentro e o que cada estação mediu |
| `/co/siata-geoportal/cameras/v1` | Cerca de 90 câmeras com a URL da última imagem de cada uma |

Todos os endpoints de estações aceitam os mesmos filtros opcionais: `latitude` e `longitude` com `radius_km` para as estações próximas, ordenadas da mais próxima para a mais distante, e `municipality` ou `station_code` para restringir. Um body vazio devolve o vale inteiro.

## Nível dos rios com limites

Cada estação de nível agora traz os limites de inundação da fonte e um `status` derivado deles, então não é preciso interpretar o nível na mão.

```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"
  }'
```

A resposta inclui `level_m`, `thresholds` (`safe_m`, `caution_m`, `minor_flood_m`, `major_flood_m`), `status` (`normal`, `elevated`, `caution`, `minor_flood`, `major_flood`), o nível máximo e médio das últimas três horas e, com `include_series: true`, uma leitura por minuto dessas três horas.

## Qualidade do ar com índice ICA

`air-quality` passa de um poluente para seis, e cada leitura traz a concentração, o índice ICA numérico e sua categoria (`Buena`, `Moderada`, `Dañina a la salud de grupos sensibles`, ...), além do poluente que domina o índice da estação.

## O que muda para quem usa o endpoint anterior

`POST /co/siata/v1` está obsoleto desde 27 de agosto de 2026 e deixará de responder em 1º de dezembro de 2026. Até lá, ele continua funcionando igual, e cada resposta traz os cabeçalhos `Deprecation` e `Sunset` e um `Link` com `rel="successor-version"`, como descreve a [política de versionamento](https://docs.usecroma.com/pt/versioning).

Para migrar:

- Clima (`meteorology`): `POST /co/siata-geoportal/weather/v1`, os mesmos campos por estação mais a série de 12 horas.
- Chuva (`rain`): `POST /co/siata-geoportal/rainfall/v1`. `accumulated_mm` agora é um objeto com sete janelas; `intensity_mm_h` não tem equivalente.
- Qualidade do ar (`air_quality`): `POST /co/siata-geoportal/air-quality/v1`. `pm25` e `air_quality_index` passam a ser `pm25.concentration` e `pm25.index`.

As respostas desta fonte ficam em cache por um minuto. O guia completo está em [SIATA Geoportal](https://docs.usecroma.com/pt/guides/colombia/siata-geoportal) e a página da fonte, em [SIATA](/co/fuentes/siata).

---

**Mais novidades:** [Ver todas as entradas do changelog](/pt/changelog/sitemap.md) | [Croma](https://usecroma.com)