Primeros pasos con la API de alquileres vacacionales
La API de Xeni Vacation Rentals le permite buscar y reservar una amplia gama de tipos de propiedades de alquiler más allá de los hoteles y resorts tradicionales. Esta API admite condominios, apartamentos, cabañas, casas flotantes, casas móviles, apartahoteles y complejos de condominios.
¿Qué son los alquileres vacacionales?
Los alquileres vacacionales son tipos de alojamiento alternativos que brindan una experiencia hogareña a los viajeros. A diferencia de las habitaciones de hotel estándar, los alquileres vacacionales suelen incluir cocinas completas, varios dormitorios y espacios privados al aire libre.
Tipos de propiedad admitidos
| Tipo de propiedad | Descripción |
|---|---|
| Condominio | Unidades de propiedad individual dentro de un edificio más grande, normalmente con servicios compartidos |
| Apartamento | Unidades residenciales independientes, a menudo en zonas urbanas |
| Casa rural | Pequeñas viviendas independientes, a menudo en entornos rurales o costeros |
| Casa flotante | Alojamiento flotante en lagos, ríos o vías navegables costeras |
| Casa móvil | Unidades residenciales transportables, a menudo en centros turísticos o parques |
| Apartahotel | Propiedades híbridas que combinan habitaciones estilo apartamento con servicios de hotel |
| Complejo de condominios | Complejos turísticos formados por unidades de condominios de propiedad individual |
En qué se diferencia de los hoteles y resorts
| Característica | API de hoteles/resorts | API de alquileres vacacionales |
|---|---|---|
| Punto final | /hotels/api/v2/properties | /hotels/api/v2/properties/vacation-rentals |
| Tipos de propiedad | Hoteles y complejos turísticos | Condominios, apartamentos, cabañas, casas flotantes, etc. |
| Filtro de tipo de propiedad | No aplicable | vacation_rentals matriz en el cuerpo de la solicitud |
| Autocompletar | Mismo punto final | Mismo punto final |
| ID de correlación | Requerido | Requerido |
/vacation-rentals) y la capacidad de filtrar por tipos de propiedades de alquiler específicos.
Flujo de integración
La integración sigue un proceso de dos pasos:
- Autocompletar: busque un destino utilizando el punto final de autocompletar compartido. Capture el
x-correlation-iddel encabezado de respuesta. - Buscar: envíe una solicitud de búsqueda al punto final de alquileres vacacionales con el ID de correlación, las fechas, la ocupación y los filtros de tipo de propiedad opcionales.
Step 1: GET /hotels/api/v2/autocomplete?key=lake+tahoe
← Response header: x-correlation-id: corr_abc123
Step 2: POST /hotels/api/v2/properties/vacation-rentals?currency=USD&page=1&limit=50
→ Header: x-correlation-id: corr_abc123
→ Body: { checkindate, checkoutdate, occupancy, lat, long, ... }
← Response: { status: "success", data: { total, hotels: [...] } }
Autenticación
La API Vacation Rentals utiliza la misma autenticación que el resto de la Colección API de Xeni. Consulte la documentación de autenticación de la API de Xeni para obtener detalles sobre Auth V2 y los encabezados requeridos.
Ambientes
| Medio ambiente | URL básica | Propósito |
|---|---|---|
| UAT (zona de pruebas) | https://uat.travelapi.ai | Desarrollo y pruebas |
| Producción | https://api.travelapi.ai | Entorno en vivo con reservas reales |
Próximos pasos
Comience aprendiendo cómo buscar ubicaciones de alquiler vacacional utilizando el punto final de autocompletar.