API de datos (v1)

API de solo consulta. No crea reservas, pagos ni cambios de cuenta. Contrato completo (OpenAPI 3.1): openapi.json para agentes y openapi.yaml, con el mismo contenido.

Convenciones

• Fechas ISO 8601 (AAAA-MM-DD), coordenadas WGS84 en grados decimales, distancias en km, importes en EUR.
• Cada recurso incluye id persistente (ULID), procedencia (frescura, fechas y fuentes) y marca demo.
• Errores: {"error": {"codigo": "...", "mensaje": "..."}} con 404 o 422. Límite: 120 peticiones por minuto (429).

Recursos

Ruta	Qué devuelve
GET /api/v1/lugares	Lugares; filtros tipo, categoria, concejo, lluvia, lat+lng+radio_km
GET /api/v1/lugares/{id}	Un lugar por ULID o slug
GET /api/v1/concejos	Concejos con zona, comarca y código INE
GET /api/v1/destinos	Destinos publicados (villas, pueblos y ciudades) con su concejo
GET /api/v1/agenda	Ediciones de eventos con estado; desde, hasta
GET /api/v1/negocios	Comer, dormir y servicios; seccion
GET /api/v1/rutas	Rutas publicadas con enlace al GPX si tienen trazado; modalidad, concejo
GET /api/v1/rutas/{id}	Una ruta por ULID o slug
GET /api/v1/buscar?q=	Búsqueda unificada con corrección de erratas
GET /api/v1/integraciones	Estado de las integraciones externas

También: /mapa/puntos.geojson (GeoJSON).