API REST.

Endpoints disponibles

Todos los endpoints son GET HTTPS sin parámetros. Devuelven JSON con CORS abierto. Click en "Ver JSON" para abrir el endpoint en una pestaña nueva.

Ejemplos de uso

Cómo consumir la API desde frontend (JavaScript) o backend (Python).

JavaScript (fetch)

// Obtener IVH actual de todos los municipios
const response = await fetch('https://terranava.org/algoritmo/api/ivh.json');
const data = await response.json();
console.log(`343 unidades territoriales cargadas`);

// Filtrar municipios CRÍTICOS
const criticos = data.municipios.filter(m => m.nivel === 'CRÍTICO');

// Ficha de un municipio específico
const ficha = await fetch('https://terranava.org/algoritmo/api/municipios/beni_riberalta.json');
const mun = await ficha.json();
console.log(`IVH ${mun.ivh.valor} - ${mun.ivh.nivel}`);

Python (requests)

import requests

# Estado de sequía actual
r = requests.get('https://terranava.org/algoritmo/api/drought.json')
data = r.json()
for d in data['estado_actual']:
    print(f"{d['departamento']}: SPI-12 = {d['spi_12m']:+.2f}")

# Histórico de un departamento
r = requests.get('https://terranava.org/algoritmo/api/departamentos/potosi.json')
print(r.json()['top_10_vulnerables'])

cURL

# Catálogo
$ curl https://terranava.org/algoritmo/api/index.json

# Estado actual sequía + pipe a jq
$ curl -s https://terranava.org/algoritmo/api/drought.json | jq '.estado_actual[] | {depto: .departamento, spi: .spi_12m}'

Detalles técnicos

Contacto técnico

Para integraciones empresariales, customizaciones o uso institucional intensivo: pablo@terranava.org. Para reportar errores en los datos o sugerir nuevos endpoints, abrí un issue describiendo el caso de uso.