Reservas
La API de reservas te permite reservar habitaciones y tarifas confirmadas por la respuesta de comprobación de los precios.
El método básico de los itinerarios de la API de reservas crea una reserva para el alojamiento, la habitación, la tarifa y la ocupación que se hayan seleccionado. La información sobre el pago, que incluye información sobre la facturación y el contacto del titular de la tarjeta, se facilita directamente dentro de la solicitud.
Cada respuesta de reserva realizada correctamente contiene enlaces para recuperar el itinerario o cancelar la reserva. Consulta nuestra sección Gestionar reservas y la página Gestionar solicitudes de reserva para más detalles.
Para hacer una reserva multi-room (del mismo tipo de habitación), primero debes hacer una solicitud a la API de compras y pasar un parámetro occupancy distinto para cada habitación. A continuación, en la solicitud de reserva, incluye las correspondientes instancias independientes de room en la matriz rooms para cada habitación que desees reservar.
Para conservar el inventario durante un breve periodo de tiempo antes de finalizar una reserva (por ejemplo, para generar un paquete), consulta nuestra documentación sobre retención y reanudación de reservas.
Para crear una reserva de prueba que no genere un cargo en tu tarjeta ni se envíe al alojamiento, consulta nuestra documentación sobre solicitudes de prueba.
Caducidad del enlace de reserva
El enlace de reserva generado en tu respuesta previa de comprobación de precios caduca tras un breve periodo de tiempo. Si, tras el primer intento, se te muestra un error HTTP 503, es probable que el enlace haya caducado. Deberás obtener un nuevo enlace y realizar un nuevo intento de reserva.
Números de identificación fiscal para reservas en INR y BRL
Debido a requisitos fiscales reglamentarios, algunas transacciones de Rapid API realizadas en rupias indias (INR) y reales brasileños (BRL) requieren una identificación fiscal individual válida del viajero pagador en el parámetro tax_registration_number.
Las solicitudes de la API Crear Reserva pueden fallar si este parámetro se deja en blanco o se proporciona un NIF no válido. Las solicitudes devolverán un error HTTP 400 con un mensaje que describe el origen del error como tax_registration_number. Para corregirlo, actualiza tax_registration_number con un número de identificación fiscal válido y vuelve a enviar la solicitud de creación de reserva.
Detalles de la API
Explora las definiciones de los puntos de conexión relacionados con las reservas en esta página y usa API Explorer u otro software de pruebas para ver la diferencia entre los ejemplos y las definiciones de esquemas, y el resultado real.
Recursos adicionales
Tanto si lo que quieres es probar todos los puntos de conexión de Rapid API como si quieres descargar las especificaciones de OpenAPI o nuestra colección de Postman, tenemos lo que necesitas.