Preguntas frecuentes sobre alquileres vacacionales

Este artículo responde preguntas comunes sobre la API de Xeni Vacation Rentals.

generales

¿En qué se diferencia la API de alquileres vacacionales de la API de hoteles?

La API Vacation Rentals busca tipos de alojamiento alternativos, como condominios, apartamentos, cabañas, casas flotantes, casas móviles, apartahoteles y complejos de condominios. Utiliza una ruta de punto final de búsqueda diferente (/hotels/api/v2/properties/vacation-rentals) pero comparte el mismo punto final de autocompletar que la API de hoteles. Las estructuras de solicitud y respuesta son similares, con la adición del filtro de tipo de propiedad vacation_rentals.

¿Los alquileres vacacionales son una API separada o parte de la API de hoteles?

Es parte de la misma infraestructura API. El punto final de autocompletar se comparte y el punto final de búsqueda sigue los mismos patrones. La diferencia clave es la ruta URL (/vacation-rentals adjunta al punto final de propiedades) y el parámetro de filtro vacation_rentals en el cuerpo de la solicitud.

¿Necesito credenciales separadas para alquileres vacacionales?

No. Las mismas credenciales API y autenticación utilizadas para la API de Hoteles o Resorts funcionan para Alquileres Vacacionales.

Tipos de propiedad

¿Puedo filtrar por tipo de propiedad?

Sí. Utilice la matriz vacation_rentals en el cuerpo de la solicitud de búsqueda para filtrar los resultados por uno o más tipos de propiedad:

{
  "vacation_rentals": [
    "Cottage",
    "Apartment"
  ]
}

Valores admitidos: "Condo", "Apartment", "Cottage", "Houseboat", "Mobile Home", "Aparthotel", "Condominium Resort".

¿Qué pasa si no especifico un tipo de propiedad?

Si omite el parámetro vacation_rentals o pasa una matriz vacía, la búsqueda devuelve todos los tipos de propiedades de alquiler vacacional disponibles para la ubicación y las fechas determinadas.

¿Los valores del tipo de propiedad distinguen entre mayúsculas y minúsculas?

Sí. Utilice los valores exactos tal como están documentados (por ejemplo, "Cottage" no "cottage", "Mobile Home" no "mobile home").

ID de búsqueda y correlación

¿Cuál es el ID de correlación?

El ID de correlación es un valor único devuelto en el encabezado de respuesta x-correlation-id desde el punto final de autocompletar. Vincula su búsqueda de autocompletar con solicitudes de búsqueda posteriores. El punto final de búsqueda requiere este encabezado para funcionar.

¿Puedo buscar sin llamar primero al autocompletar?

No. El punto final de autocompletar proporciona el ID de correlación, el ID del lugar y las coordenadas necesarias para la solicitud de búsqueda. Primero debes llamar al autocompletar.

¿Puedo reutilizar un ID de correlación para múltiples búsquedas?

Un ID de correlación está vinculado a una solicitud de autocompletar específica. Para el mismo destino, puede usarlo para múltiples solicitudes de búsqueda (por ejemplo, diferentes fechas u ocupación). Sin embargo, si busca un nuevo destino, debe volver a llamar a la función de autocompletar para obtener una nueva ID de correlación.

¿Qué sucede si omito el ID de correlación?

La búsqueda devuelve un error 400 que indica que falta el ID de correlación.

Precios

¿Cómo funcionan los precios para los alquileres vacacionales?

Cada propiedad en los resultados de la búsqueda incluye un objeto rates con los siguientes campos:

¿Puedo cambiar la moneda?

Sí. Pase la moneda deseada como parámetro de consulta: currency=EUR, currency=GBP, etc. Todos los precios en la respuesta estarán en la moneda especificada. Si se proporciona una moneda no admitida, la API devuelve un error 400.

¿Los precios son por noche o por estancia?

Los campos retailprice y baserate son por noche. Los campos totalrate y taxand_fees son para la duración completa de la estadía.

Filtrado y clasificación

¿Qué filtros están disponibles?

Se pueden pasar los siguientes filtros en el objeto filters:

¿Cómo ordeno los resultados?

Utilice la matriz sort en el cuerpo de la solicitud:

{
  "sort": [
    {
      "key": "price",
      "order": "asc"
    }
  ]
}

¿Cómo funciona la paginación?

Utilice los parámetros de consulta page y limit. Las páginas comienzan en 1 y el límite máximo por página es 50. Marque data.total en la respuesta para determinar cuántas páginas de resultados existen.

Modo asíncrono

¿Cuándo debo usar el modo asíncrono?

Utilice el modo asíncrono (is_async: true) cuando cree experiencias de búsqueda orientadas al usuario en las que desee mostrar resultados lo más rápido posible. La API devuelve resultados parciales inmediatamente y usted realiza una encuesta para obtener más resultados hasta que todos los proveedores hayan respondido.

¿Cómo sé cuándo están todos los resultados?

Verifique el campo status en la respuesta. Cuando es igual a "success", se han devuelto todos los resultados. Si bien es igual a "in_progress", continúe sondeando con el mismo ID de correlación.

¿Qué pasa si el modo de sincronización devuelve "in_progress"?

Si una solicitud de sincronización caduca antes de que todos los proveedores respondan, la respuesta puede tener status: "in_progress". Trate esto como una respuesta asíncrona y vuelva a realizar la encuesta con el mismo ID de correlación.

Soporte en varios idiomas

¿Puedo obtener resultados en otros idiomas?

El punto final de autocompletar admite el encabezado Accept-Language. Pase un código de idioma (por ejemplo, "ar" para árabe, "es" para español, "fr" para francés) para recibir nombres de ubicaciones localizadas.

GET /hotels/api/v2/autocomplete?key=paris
Accept-Language: es

¿Se traducen los nombres y descripciones de las propiedades?

Los nombres y descripciones de las propiedades se proporcionan según lo registrado por la propiedad y es posible que no estén disponibles en todos los idiomas. El encabezado Accept-Language afecta principalmente a los resultados de ubicación de autocompletar.

Errores

¿Cuáles son los códigos de error comunes?

Soporte

Para obtener ayuda adicional con la API de Vacation Rentals, comuníquese con el soporte de Xeni al customersupport@xeni.com.