Primeros pasos con Xeni Quick Builder
Xeni Quick Builder es un motor de reservas de marca blanca que le permite ofrecer capacidades de búsqueda y reserva de hoteles directamente dentro de su plataforma. A diferencia de las API de Xeni independientes, Quick Builder proporciona una interfaz de reserva completamente renderizada que se integra mediante autenticación basada en SSO.
¿Qué es Quick Builder?
Quick Builder es una experiencia de reserva alojada impulsada por Xeni. Sus usuarios se autentican a través de su plataforma y una redirección de SSO segura los registra en el entorno de marca blanca de Xeni. Desde allí, pueden buscar hoteles, ver resultados y completar reservas, todo dentro de una experiencia de marca que coincida con su plataforma.
Cómo funciona la autenticación SSO
Quick Builder utiliza el inicio de sesión único basado en JWT (JSON Web Token) en lugar de la autenticación basada en firma Auth V2 utilizada por las API de Xeni. El flujo funciona de la siguiente manera:
- El usuario inicia sesión en su plataforma: su aplicación autentica al usuario a través de su propio sistema de inicio de sesión.
- Su servidor genera un JWT: cuando el usuario está listo para acceder al motor de reservas, su backend crea un JWT firmado que contiene las afirmaciones de identidad del usuario.
- Redireccionar a Xeni: su aplicación redirige al usuario a la URL de SSO de Xeni con el token JWT y una ruta de destino.
- Xeni valida el token: Xeni llama a su punto final de validación JWT para verificar que el token sea auténtico y no haya caducado.
- El usuario accede a Quick Builder: una vez validado, el usuario inicia sesión en el motor de reservas de marca blanca y puede buscar y reservar hoteles.
Formato de URL de redireccionamiento SSO
La URL de redireccionamiento sigue esta estructura:
https://your-xeni-domain.com/sso?token={JWTTOKEN}&navigateTo={ENCODEDDESTINATION}
| Parámetro | Descripción |
|---|---|
token | El token JWT firmado generado por su servidor |
navigateTo | Ruta codificada en URL dentro del motor de reservas (por ejemplo, /hotels/search) |
Lista de verificación de integración
Para completar su integración con Quick Builder, deberá:
| Paso | Descripción | Artículo |
|---|---|---|
| 1. Generar tokens JWT | Cree tokens firmados con los reclamos requeridos | Configurar autenticación SSO |
| 2. Cree un punto final de validación | Exponer un punto final POST al que Xeni llama para verificar tokens | Crear un punto final de validación JWT |
| 3. Configurar el panel de administración | Registre su URL de validación y dominio de emisor en el administrador de Xeni | Configurar Quick Builder en Xeni Admin |
| 4. Búsqueda de hoteles | Utilice los puntos finales de búsqueda y autocompletar para encontrar propiedades | Buscar Hoteles |
| 5. Aplicar filtros | Limitar resultados por clasificación, servicios, precio y más | Usar filtros de búsqueda de hoteles |
Diferencias clave con las API de Xeni
| Característica | Constructor rápido | API de Xeni |
|---|---|---|
| Autenticación | SSO basado en JWT | Auth V2 (generación de firma) |
| Interfaz | Interfaz de usuario de marca blanca alojada | Puntos finales de API sin procesar |
| Flujo de reservas | La interfaz de usuario integrada gestiona el pago | Usted construye todo el flujo de pago |
| Búsqueda de hoteles | Los mismos puntos finales que la API de Hoteles | Acceso directo a la API |
Próximos pasos
Comience configurando la autenticación SSO. Esta es la base de su integración con Quick Builder y debe completarse antes de cualquier otra configuración.