Comenzando con la API de Xeni Resorts

La API v2 de Xeni Resorts le brinda acceso programático a un inventario global de propiedades turísticas. Con una única integración, puede buscar destinos, explorar complejos turísticos disponibles, comprobar la disponibilidad y los precios de las habitaciones y completar reservas completamente a través de API.

Qué puedes hacer

La API de Resorts v2 admite el ciclo de vida completo de las reservas:

• Buscar destinos: utilice la función de autocompletar para buscar ciudades, regiones, estados o países y recuperar los códigos de región necesarios para las búsquedas de propiedades.
• Buscar complejos turísticos: consulte propiedades turísticas disponibles por región, fechas, precios, clasificaciones, servicios y más.
• Obtener detalles de la propiedad: recupere información completa de la propiedad, incluidas imágenes, políticas, horarios de entrada y salida y calificaciones.
• Ver instalaciones: busque características de accesibilidad, aeropuertos cercanos y servicios dentro o fuera del sitio para cualquier propiedad.
• Ver disponibilidad de habitaciones: vea las habitaciones disponibles con precios en tiempo real para fechas específicas.
• Confirmar precio: obtenga el precio final y un ID de sesión antes de reservar.
• Retener y confirmar reservas: reserve una propiedad retenida y luego confírmela o libérela.
• Recuperar detalles de la reserva: busque información completa de la reserva, incluidos desgloses de tarifas, detalles del viajero y políticas de propiedad.

Ambientes

Versiones de API

Todos los puntos finales del resort utilizan el prefijo de ruta v2 en /resorts/api/v2. A continuación se muestra un resumen de los puntos finales disponibles:

GET  /resorts/api/v2/search
POST /resorts/api/v2/properties/{xeniregioncode}
GET  /resorts/api/v2/property/{property_id}
GET  /resorts/api/v2/properties/availability
GET  /resorts/api/v2/properties/price
POST /resorts/api/v2/itineraries
PUT  /resorts/api/v2/itineraries
GET  /resorts/api/v2/booking/{reference_number}

Requisitos previos

Antes de comenzar, necesitará:

1. Clave API: su clave API única, proporcionada durante la incorporación.
2. API Secret: su clave secreta, que se utiliza junto con la clave API para generar firmas de autenticación.

Encabezados requeridos

Todas las solicitudes a la API de Resorts deben incluir los siguientes encabezados:

Inicio rápido: su primera búsqueda de resort

Aquí está el flujo mínimo para buscar resorts. Cada paso se trata en detalle en artículos posteriores.

Paso 1: buscar un destino

Utilice el punto final de autocompletar para buscar un destino y recuperar su código de región.

GET {{api_host}}/resorts/api/v2/search?key=hawaii
// Response
{
  "status": 200,
  "data": [
    {
      "name": "Hawaii",
      "full_name": "Hawaii, United States",
      "city": "",
      "state": "Hawaii",
      "country": "United States",
      "region": "aGF3YWlp",
      "type": "state",
      "popularity": 95,
      "location": {
        "lat": 19.8968,
        "lon": -155.5828
      }
    }
  ]
}

Guarde el valor region (un código codificado en Base64); lo necesitará para la búsqueda de propiedades.

Paso 2: buscar complejos turísticos

Utilice el código de región de la respuesta de autocompletar para buscar propiedades turísticas disponibles.

POST {{api_host}}/resorts/api/v2/properties/aGF3YWlp?currency=USD
{
  "stay_period": {
    "start": "2026-04-01",
    "end": "2026-04-07"
  },
  "lat": 19.8968,
  "lon": -155.5828
}

Paso 3: Verifique la disponibilidad y los precios

Una vez que haya identificado una propiedad, verifique la disponibilidad de habitaciones y luego confirme el precio antes de reservar.

Paso 4: Mantenga presionado y confirme

Cree una retención en la reserva y luego confírmela para finalizar la reserva.

Formato de respuesta

Todas las respuestas de la API devuelven JSON. Las respuestas exitosas incluyen un campo status y envuelven su carga útil en una propiedad data:

{
  "status": 200,
  "data": { ... }
}

Las respuestas de error siguen una estructura consistente:

{
  "message": "Description of the error",
  "status": 400
}

Artículo siguiente: Cómo buscar destinos turísticos