Introducción a la API¶
Producto: OpenBooking | Módulo: Integración API | Última actualización: 2026-08-12
Introducción¶
OpenBooking expone una API REST para conectar sitios web propios, aplicaciones móviles y sistemas de terceros. Este libro es técnico: está escrito para quien desarrolla la integración.
Qué permite¶
| Área | Operaciones |
|---|---|
| Catálogo | Buscar servicios, obtener fichas, consultar disponibilidad |
| Reservas | Agregar al carrito, hacer checkout, consultar una reserva |
| Pagos | Listar pasarelas, iniciar el pago, recibir la confirmación |
| Usuarios | Registro, sesión, perfil, historial, lista de deseos |
| Contenido | Ubicaciones, noticias, configuración del sitio |
| Opiniones | Publicar reseñas de un servicio |
Convenciones¶
| Aspecto | Detalle |
|---|---|
| Base | /api sobre el dominio de su instalación |
| Formato | JSON en peticiones y respuestas |
| Autenticación | Token Bearer para los recursos protegidos |
| Idioma | Se resuelve por la configuración de idioma de la petición |
Endpoints públicos y protegidos¶
| Tipo | Requiere token | Ejemplos |
|---|---|---|
| Públicos | No | Búsqueda, fichas, disponibilidad, ubicaciones |
| Protegidos | Sí | Perfil, historial de reservas, lista de deseos, reseñas |
Recorrido típico de una integración¶
1. GET /api/configs configuración del sitio
2. GET /api/{tipo}/search buscar disponibilidad
3. GET /api/{tipo}/detail/{id} ficha del servicio
4. GET /api/{tipo}/availability/{id} verificar fechas
5. POST /api/booking/addToCart armar la reserva
6. POST /api/booking/doCheckout confirmar y pagar
7. GET /api/booking/{code} consultar el resultado
Tipos de servicio¶
El segmento {tipo} de las rutas corresponde al tipo de servicio:
| Valor | Servicio |
|---|---|
hotel |
Hoteles |
cabin |
Cabañas |
space |
Espacios |
tour |
Tours |
car |
Autos |
boat |
Botes |
event |
Eventos |
flight |
Vuelos |
ℹ️ Nota: Solo responden los tipos habilitados en su instalación y en su plan.
Antes de empezar¶
- Confirme la URL base de su instalación.
- Verifique qué tipos de servicio tiene activos.
- Cree un usuario de pruebas.
- Configure la pasarela en modo de prueba antes de tocar pagos reales.
Recorrido del libro¶
| Página | Cubre |
|---|---|
| Autenticación | Tokens y sesión |
| Búsqueda y disponibilidad | Consultar el catálogo |
| Crear una reserva | Carrito y checkout |
| Pagos y confirmación | Pasarelas y retornos |
| Datos del usuario | Perfil, historial, favoritos |
¿Necesita ayuda adicional? Contacte a soporte: soporte@openx.cl