Online Booking API
Conecta el motor de reservas del sitio web del hotel con HMS: lista de habitaciones y tarifas, disponibilidad en calendario, cupones, pago y envío de reservas.
- URL base
https://test.hms.gen.tr- Autenticación
- apiKey / apiSecret → token Bearer
- Formato
- Respuestas JSON · cuerpos de solicitud en formulario o JSON
- Alcance
- 8 recursos · 16 endpoints
Recursos#
Autenticación
1 endpointEl acceso a la API de Online Booking se realiza con credenciales de partner emitidas por HMS. El endpoint de inicio de sesión canjea apiKey y apiSecre…
- POST
/external/public/login
Habitaciones y tarifas
2 endpointsDos endpoints que alimentan los resultados de búsqueda del motor de reservas: la lista de habitaciones, que devuelve los tipos de habitación a la vent…
- POST
/external/online/roomType - GET
/external/room/type/hotel/availability
Reserva
1 endpointLa habitación, el régimen y la tarifa que eligió el huésped se envían a HMS en una estructura BookingPushRQ. El mismo endpoint gestiona cancelaciones …
- POST
/external/online/channel/booking
Pago
3 endpointsLista los tipos de pago que el hotel acepta en las reservas online e inicia el paso de pago para el tipo seleccionado. Qué hacer con cada tipo se expl…
- GET
/external/online/payment/type - GET
/external/payment/company - POST
/external/online/payment/type/{paymentType}
Cupón
1 endpointValida los cupones de descuento online que el hotel ha definido en el panel. Aplica el descuento en tu sistema y envía los importes con descuento al e…
- POST
/external/online/coupon/search
Paquetes y extras
1 endpointExtras que se pueden vender junto con una reserva: paquetes de habitación (vinculados a un tipo de habitación) y paquetes generales (traslado, cena, s…
- GET
/external/stock/packages
Información del hotel
4 endpointsDatos que completan la estructura de las páginas del motor de reservas: datos de contacto y ubicación, enlaces a redes sociales, textos del pie de pág…
- GET
/external/hotel/{hotelID}/contact/info - GET
/external/online/social/media - GET
/external/online/footer - +1 más
Catálogos
3 endpointsListas estáticas para las opciones de los formularios: países, monedas e idiomas. Cambian muy poco y se pueden guardar en caché durante un día.
- POST
/external/counties - GET
/external/currencies - GET
/external/languages
Documentación#
Primeros pasos
- Descripción generalQué hace la API de Online Booking, URL base, resumen del flujo y reglas generales.
- Inicio rápidoObtén un token con tus credenciales de partner y envía tu primera consulta de habitaciones y tarifas.
- AutenticaciónInicio de sesión con apiKey / apiSecret, token Bearer, contexto del hotel y vigencia del token.
- Solicitudes y respuestasCuerpos de formulario y JSON, el envoltorio success, paginación, formatos de fecha e importe, códigos de estado HTTP.
- Códigos de errorValores de message y errorCode, errores de autenticación y recomendaciones de reintento.