API para operadores
API REST pública. Sin autenticación para endpoints públicos.
Los endpoints B2B requieren el header X-API-Key.
Base URL
https://alertaparques.cl/api/v1
Endpoints públicos
GET
/parques Lista todos los parques con estado actual GET
/parques/:slug Detalle del parque con senderos, forecast 72h y alertas GET
/parques/:slug/senderos Senderos del parque con condiciones actuales GET
/alertas Alertas activas (todas) GET
/alertas?parque=:slug Alertas filtradas por parque GET
/alertas?nivel=rojo Alertas filtradas por nivel (peligro, precaucion, etc.) POST
/suscriptores Crear suscripción por email o Web Push DELETE
/suscriptores/:token Cancelar suscripción sin login GET
/health Health check del servicio Endpoints B2B
Requieren header X-API-Key: tu_clave. Contacta api@alertaparques.cl para solicitar acceso.
GET
/bulk/condiciones Dump de todas las condiciones de las últimas 24h GET
/bulk/parques Todos los parques con datos completos (senderos + alertas + condiciones) Formato de respuesta
Todos los endpoints retornan el mismo envelope:
{
"data": { ... }, // null si hay error
"error": null, // string si hay error
"ts": "2025-11-15T14:30:00.000Z"
} Límites de uso
- • Endpoints públicos: 100 solicitudes/minuto por IP
- • Endpoints B2B: 1.000 solicitudes/minuto
- • Cache-Control:
public, max-age=300en GETs públicos