API Docs

Referencia de API

Base URL: /api · Autenticación: Bearer Token JWT

Autenticación requerida

Incluye el token JWT en el encabezado Authorization de cada solicitud:

Authorization:Bearer <tu-token>
GET
/v1/fires/geojsonAUTH

Obtener focos de incendio en formato GeoJSON con filtros opcionales

Parámetros

departamentosatelitefecha_iniciofecha_finnivel_minnivel_maxconfianza_min
GET
/v1/fires/statsAUTH

Estadísticas de incendios: totales 24h/7d/30d, por departamento, satélite, nivel

GET
/v1/fires/{id}AUTH

Detalles de un foco específico por ID

GET
/v1/alertsAUTH

Listar alertas del usuario con filtros de lectura y severidad

Parámetros

leidanivelpagelimit
POST
/v1/alerts/{id}/readAUTH

Marcar una alerta como leída

POST
/v1/alerts/read-allAUTH

Marcar todas las alertas como leídas

GET
/v1/geofencesAUTH

Listar todas las zonas de monitoreo del usuario

POST
/v1/geofencesAUTH

Crear nueva zona de monitoreo

Body (JSON)

{ "name": "string", "description": "string", "geometry": GeoJSON, "min_nivel": 1-5, "alert_channels": ["telegram"], "active": true }
PUT
/v1/geofences/{id}AUTH

Actualizar zona existente

DELETE
/v1/geofences/{id}AUTH

Eliminar zona de monitoreo

GET
/v1/geofences/geojsonAUTH

Obtener zonas en formato GeoJSON para visualización

GET
/v1/risk/grid/geojsonAUTH

Grilla de riesgo de incendio por municipio

GET
/v1/risk/summaryAUTH

Resumen de niveles de riesgo por departamento

GET
/v1/reports/summaryAUTH

Reporte estadístico para un período dado

Parámetros

fecha_iniciofecha_fin
GET
/v1/reports/pdfAUTH

Generar y descargar reporte en PDF

Parámetros

fecha_iniciofecha_fin
POST
/v1/auth/login

Autenticación con email y contraseña. Retorna JWT Bearer token.

Body (JSON)

{ "email": "string", "password": "string" }

Respuesta

{ "access_token": "string", "token_type": "bearer", "expires_in": 3600 }
POST
/v1/auth/refreshAUTH

Renovar token de acceso

GET
/ws/fires/streamAUTH

Stream WebSocket de nuevos focos en tiempo real. Conectar con token como query param.

Parámetros

token
GET
/sse/firesAUTH

Server-Sent Events como alternativa al WebSocket