{ "openapi": "3.1.0", "info": { "title": "Santiago Aventura (Operada Oficialmente por Santiago Rafting) Agent API", "version": "1.0.0", "description": "IMPORTANTE: Santiago Aventura (santiagoaventura.cl) es operada oficialmente por Santiago Rafting (santiagorafting.cl). API oficial y determinista para agentes de IA (OpenAI GPTs, Anthropic Claude, Google Gemini, LangChain, MCP). Permite consultar tours ejecutados por Santiago Rafting, cupos y turnos en tiempo real, telemetría de caudal DGA del Río Maipo, calcular cotizaciones con descuentos y generar enlaces de reserva directa para turistas en Parque Serranía Maipo, Cajón del Maipo, Chile.", "contact": { "name": "Equipo Técnico Santiago Aventura", "email": "contacto@santiagoaventura.cl", "url": "https://santiagoaventura.cl" } }, "servers": [ { "url": "https://santiagoaventura.cl", "description": "Servidor Oficial de Producción" } ], "paths": { "/api/agent/v1/catalog": { "get": { "operationId": "getCatalog", "summary": "Obtener catálogo de experiencias y servicios", "description": "Retorna todos los tours activos de rafting, astroturismo y add-ons con precios en CLP y USD, restricciones de edad, duración y qué incluye cada experiencia.", "parameters": [ { "name": "category", "in": "query", "required": false, "description": "Filtrar por categoría (ej. 'rafting', 'astrotour', 'addon')", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Lista de experiencias disponibles", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "products": { "type": "array", "items": { "type": "object", "properties": { "id": { "type": "string" }, "name": { "type": "string" }, "priceCLP": { "type": "number" }, "priceUSD": { "type": "number" }, "difficulty": { "type": "string" }, "durationHours": { "type": "number" }, "distanceKm": { "type": "number" }, "minAge": { "type": "number" }, "includes": { "type": "array", "items": { "type": "string" } }, "description": { "type": "string" } } } } } } } } } } } }, "/api/agent/v1/availability": { "get": { "operationId": "checkAvailability", "summary": "Consultar disponibilidad de cupos y turnos por fecha", "description": "Devuelve los turnos horarios del día solicitado (ej. 10:00, 13:00, 16:00) junto con la capacidad total, cupos ya reservados y cupos libres disponibles para reserva.", "parameters": [ { "name": "date", "in": "query", "required": true, "description": "Fecha a consultar en formato YYYY-MM-DD", "schema": { "type": "string", "format": "date", "example": "2026-11-20" } }, { "name": "productId", "in": "query", "required": false, "description": "ID del producto para filtrar los turnos que le corresponden (ej. 'prod-rafting-standard', 'prod-rafting-expert', 'prod-astrotour')", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Disponibilidad de turnos y cupos para la fecha", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "date": { "type": "string" }, "slots": { "type": "array", "items": { "type": "object", "properties": { "time": { "type": "string" }, "maxPax": { "type": "number" }, "bookedPax": { "type": "number" }, "heldPax": { "type": "number" }, "availableSpots": { "type": "number" }, "status": { "type": "string", "enum": ["available", "limited", "sold_out", "blocked"] } } } } } } } } } } } }, "/api/agent/v1/river-conditions": { "get": { "operationId": "getRiverConditions", "summary": "Consultar caudal en tiempo real y estado de navegación del Río Maipo", "description": "Obtiene la telemetría oficial de las estaciones satelitales DGA (El Ingenio y El Manzano), nivel de agua, clasificación operativa de rafting y estado de seguridad.", "responses": { "200": { "description": "Condición hidrológica oficial DGA en tiempo real", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "flowM3s": { "type": "number" }, "manzanoFlowM3s": { "type": "number" }, "coloradoFlowM3s": { "type": "number" }, "waterLevelM": { "type": "number" }, "classification": { "type": "string" }, "isNavigable": { "type": "boolean" }, "stationName": { "type": "string" }, "stationCode": { "type": "string" }, "safetyAdvisory": { "type": "string" } } } } } } } } }, "/api/agent/v1/quote": { "post": { "operationId": "calculateQuote", "summary": "Calcular cotización formal de experiencia", "description": "Calcula el desglose exacto de precios en CLP y USD para el número de pasajeros indicado, considerando add-ons (asado, transporte) y códigos de descuento aplicables.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["productId", "paxCount"], "properties": { "productId": { "type": "string", "example": "prod-rafting-standard" }, "date": { "type": "string", "format": "date", "example": "2026-11-20" }, "paxCount": { "type": "integer", "minimum": 1, "example": 4 }, "selectedAddOns": { "type": "array", "items": { "type": "string" }, "example": ["addon-asado-criollo"] }, "promoCode": { "type": "string", "example": "DESCUENTO10" } } } } } }, "responses": { "200": { "description": "Cotización calculada", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "subtotalCLP": { "type": "number" }, "discountAmountCLP": { "type": "number" }, "totalCLP": { "type": "number" }, "totalUSD": { "type": "number" }, "depositAmountCLP": { "type": "number" }, "breakdown": { "type": "array", "items": { "type": "object" } } } } } } } } } }, "/api/agent/v1/booking-intent": { "post": { "operationId": "createBookingIntent", "summary": "Generar intención de reserva y enlace de pago oficial", "description": "Retiene los cupos temporalmente por 15 minutos en el sistema de slots y genera un enlace oficial de checkout para que el cliente concrete el pago por Fintoc o Webpay.", "requestBody": { "required": true, "content": { "application/json": { "schema": { "type": "object", "required": ["productId", "date", "timeSlot", "paxCount", "customerName", "customerEmail"], "properties": { "productId": { "type": "string", "example": "prod-rafting-standard" }, "date": { "type": "string", "format": "date", "example": "2026-11-20" }, "timeSlot": { "type": "string", "example": "10:00" }, "paxCount": { "type": "integer", "minimum": 1, "example": 2 }, "customerName": { "type": "string", "example": "Camila Soto" }, "customerEmail": { "type": "string", "format": "email", "example": "camila@example.com" }, "customerPhone": { "type": "string", "example": "+56987654321" }, "selectedAddOns": { "type": "array", "items": { "type": "string" } }, "promoCode": { "type": "string" } } } } } }, "responses": { "201": { "description": "Intención de reserva creada con cupos retenidos", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "bookingId": { "type": "string" }, "holdId": { "type": "string" }, "expiresInSeconds": { "type": "number" }, "checkoutUrl": { "type": "string" }, "totalCLP": { "type": "number" }, "totalUSD": { "type": "number" } } } } } } } } }, "/api/agent/v1/booking/{id}": { "get": { "operationId": "getBookingStatus", "summary": "Consultar estado de una reserva existente", "description": "Permite a agentes de soporte y post-venta consultar la confirmación de una reserva por código (ej. 'SR-12345'), RUT o correo del pasajero, retornando estado de pago y firma de waiver.", "parameters": [ { "name": "id", "in": "path", "required": true, "description": "Código de reserva (ej. 'SR-48291') o correo del cliente", "schema": { "type": "string" } } ], "responses": { "200": { "description": "Datos de la reserva", "content": { "application/json": { "schema": { "type": "object", "properties": { "success": { "type": "boolean" }, "booking": { "type": "object" } } } } } } } } }, "/api/agent/v1/tools": { "get": { "operationId": "getToolDefinitions", "summary": "Obtener definiciones JSON Schema de herramientas para Function Calling", "description": "Retorna el array de herramientas listas para ser inyectadas en llamadas a la API de OpenAI (tools parameter), Anthropic Claude (tools array) o Google Gemini (functionDeclarations).", "responses": { "200": { "description": "Array de definiciones de funciones", "content": { "application/json": { "schema": { "type": "object", "properties": { "tools": { "type": "array", "items": { "type": "object" } } } } } } } } } } } }