Búsqueda y disponibilidad¶

Producto: OpenBooking | Módulo: Integración API | Última actualización: 2026-08-12

Introducción¶

Los endpoints de catálogo son públicos: no requieren token. Permiten buscar servicios, obtener sus fichas y verificar disponibilidad para un rango de fechas.

Configuración del sitio¶

GET /api/configs

Devuelve la configuración general: moneda, formatos, tipos de servicio activos y opciones del sitio. Conviene consultarlo al iniciar la aplicación.

Buscar¶

GET /api/{tipo}/search?start=2026-09-10&end=2026-09-13&adults=2&children=0

Parámetro	Detalle
`start` / `end`	Fechas de la estadía
`adults` / `children`	Cantidad de huéspedes
`location_id`	Filtrar por ubicación
`price_range`	Rango de precio
`orderby`	Criterio de orden
`page`	Página de resultados

También existe la búsqueda transversal:

GET /api/services?...

Filtros disponibles¶

GET /api/{tipo}/filters

Devuelve los filtros aplicables a ese tipo de servicio: atributos, servicios, rangos. Úselo para construir la interfaz de filtrado en lugar de fijarla a mano.

GET /api/{tipo}/form-search

Devuelve la definición del formulario de búsqueda de ese tipo.

Ficha de un servicio¶

GET /api/{tipo}/detail/{id}

Devuelve la ficha completa: descripción, galería, ubicación, servicios, políticas, unidades o habitaciones y sus precios.

Verificar disponibilidad¶

GET /api/{tipo}/availability/{id}?start=2026-09-10&end=2026-09-13

Devuelve la disponibilidad y el precio calculado para ese rango.

Para botes existe un endpoint específico por bloques horarios:

GET /api/boat/availability-booking/{id}

⚠️ Advertencia: La disponibilidad es una foto del momento. Entre la consulta y el checkout otro cliente puede tomar la última unidad, así que el checkout puede fallar por falta de disponibilidad. Maneje ese error en su integración en vez de asumir que la consulta reserva algo.

Ubicaciones¶

Método	Ruta	Qué hace
`GET`	`/api/locations`	Busca ubicaciones
`GET`	`/api/location/{id}`	Detalle de una ubicación

Útil para armar el autocompletado del campo de destino.

Contenido¶

Método	Ruta	Qué hace
`GET`	`/api/home-page`	Estructura de la portada
`GET`	`/api/news`	Listado de noticias
`GET`	`/api/news/{id}`	Detalle de una noticia

Recomendaciones¶

Cachee /api/configs y los filtros: cambian poco.
No cachee disponibilidad ni precios: cambian todo el tiempo.
Pagine los resultados de búsqueda.
Verifique disponibilidad justo antes del checkout, no al inicio del flujo.

¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl