Consulta de datos de precios de hoteles

La comparación de precios registrados de hoteles de OTI es un servicio público que viajeros y herramientas de búsqueda con IA pueden leer sin iniciar sesión. El piloto público actual abarca fechas de viernes recopiladas de 3 hoteles de Da Nang · 2 adultos · 0 niños · 1 habitación · 1 noche · USD. No ofrece inventario en tiempo real, reservas ni pagos.

Al indicar el destino, las fechas y el número de personas como condiciones en la URL, se consultan en HTML o JSON los registros por vendedor de varios hoteles. No se necesita iniciar sesión ni JavaScript.

Si el número de adultos, niños, habitaciones o noches, o la moneda, quedan fuera del rango admitido, se responde con 422 y no se devuelven precios alternativos. Aunque las fechas futuras sean válidas, puede que no haya registros recopilados.

destination es el nombre de la zona o un nombre de ruta como da-nang. checkin/checkout es un par YYYY-MM-DD; si se omite, se devuelven las fechas de estancia recopiladas. Se puede filtrar con breakfast=included, cancellation=free_cancel y maxTotal=importe en USD. maxTotal solo se aplica a filas con impuestos incluidos confirmados. Si se omiten los filtros, también se devuelven registros con condiciones no confirmadas. comparable es un indicador para la ordenación existente por precio con impuestos incluidos, y no verifica que coincidan la habitación, las personas a las que se aplica, las personas con desayuno, la hora y zona horaria de cancelación ni la penalización.

Se consultan 6 hoteles cada vez y, tras aplicar las condiciones de desayuno, cancelación e importe total, se devuelven hasta 30 precios registrados por página para cada hotel y fecha de estancia. Aunque no haya resultados, si existe next, consulta la siguiente página de hoteles. Las opciones restantes del mismo hotel y fecha de estancia se consultan con dates[].nextOffersUrl. En offerPage, totalRows es el número de registros guardados, matchingRows el número que cumple las condiciones y offset·returnedRows el rango actual. Si cambian los resultados de la recopilación, se devuelven 409 y restart, así que vuelve a consultar desde el principio. previousRooms es un registro detallado anterior, independiente, que se ofrece cuando la observación más reciente no tiene condiciones de habitación. Comprueba por separado la hora de observación anterior, el número de coincidencias con el filtro y nextOffersUrl, y no apliques las condiciones anteriores al precio más reciente. Al pasar de página en el detalle anterior, el precio más reciente vuelve a la primera página. Los registros anteriores se excluyen del precio destacado y de la selección más recientes; aunque haya registros anteriores que cumplan las condiciones, si no hay coincidencias recientes, el resultado es no_observations. no_observations no significa agotado. Comprueba también la hora de observación y stale de cada fila. responseAsOf es la hora de referencia del procesamiento de la solicitud (UTC), no la hora de recopilación del precio. observationAgeSeconds son los segundos transcurridos desde la observación respecto a esa referencia, y es null si la hora no está confirmada o es futura. hotels[].comparisonUrl es el enlace de comparación de cada hotel que mantiene las condiciones de consulta. Se puede especificar un hotel con hotelId.

Consulta JSON de Da Nang · Los mismos registros en HTML · OpenAPI · Guía en Markdown para agentes · Ejemplo JSON: desayuno · cancelación gratuita · USD150 o menos