Cómo comprobar la disponibilidad y el precio de las habitaciones

Antes de crear una reserva, primero debe verificar la disponibilidad de habitaciones para una propiedad específica y luego confirmar el precio final. Estos dos pasos garantizan que la habitación esté disponible y que la tarifa esté fijada antes de pasar a la etapa de reserva.

Paso 1: Verificar la disponibilidad de habitaciones

Punto final

GET {{api_host}}/resorts/api/v2/properties/availability

Encabezados requeridos

Parámetros de consulta

Solicitud de ejemplo

GET {{apihost}}/resorts/api/v2/properties/availability?propertyid=RST-98765&checkin=2026-04-01&checkout=2026-04-07&currency=USD&recommendation_id=rec-abc123

Ejemplo de respuesta

{
  "status": 200,
  "data": [
    {
      "checkin_date": "2026-04-01",
      "checkout_date": "2026-04-07",
      "token": "tkn-xyz789",
      "base_rate": 245,
      "taxesandfees": 38.5,
      "total_rate": 1710,
      "kitchen_type": "full",
      "max_occupancy": 6,
      "room_name": "Oceanview Two-Bedroom Suite",
      "recommendation_id": "rec-abc123",
      "published_price": 1850
    },
    {
      "checkin_date": "2026-04-01",
      "checkout_date": "2026-04-07",
      "token": "tkn-def456",
      "base_rate": 195,
      "taxesandfees": 30.75,
      "total_rate": 1365,
      "kitchen_type": "partial",
      "max_occupancy": 4,
      "room_name": "Garden View One-Bedroom",
      "recommendation_id": "rec-abc123",
      "published_price": 1500
    }
  ]
}

Campos de respuesta

Notas importantes

• Cada habitación en la respuesta tiene su propio token. Guarde el token para la habitación específica que seleccione el usuario; es necesario para el paso de confirmación del precio.
• Los resultados de disponibilidad son en tiempo real pero no se mantienen. Otro huésped podría reservar la habitación entre su verificación de disponibilidad y su intento de reserva. Proceda siempre a la confirmación del precio con prontitud.

Paso 2: Confirmar el precio

Después de que el usuario seleccione una habitación, confirme el precio final antes de crear una reserva.

Punto final

GET {{api_host}}/resorts/api/v2/properties/price

Encabezados requeridos

Parámetros de consulta

Solicitud de ejemplo

GET {{apihost}}/resorts/api/v2/properties/price?checkin=2026-04-01&checkout=2026-04-07&propertyid=RST-98765&currency=USD&recommendation_id=rec-abc123&token=tkn-xyz789

Ejemplo de respuesta

{
  "status": 200,
  "data": {
    "sessionId": "sess-001234",
    "propertyId": "RST-98765",
    "availability": [
      {
        "checkInDate": "2026-04-01",
        "checkOutDate": "2026-04-07",
        "baseRate": 245,
        "taxesAndFees": 38.5,
        "totalRate": 1710,
        "currency": "USD",
        "roomName": "Oceanview Two-Bedroom Suite",
        "token": "tkn-xyz789",
        "recommendationId": "rec-abc123",
        "publishedPrice": 1850
      }
    ]
  }
}

Campos de respuesta

Notas importantes- Convención de nomenclatura de campos: el punto final de precios devuelve campos en camelCase (p. ej., checkInDate, baseRate), a diferencia del punto final de disponibilidad que usa Snakecase (p. ej., checkindate, base_rate). Tenga en cuenta esta diferencia en su integración.

• Utilice el totalRate confirmado: la respuesta sobre el precio refleja la tarifa final confirmada. Utilice siempre este valor (no la disponibilidad anterior ni la tarifa de búsqueda) al crear la reserva. Si el total_rate en su solicitud de reserva no coincide, la API devuelve un error 400.

Flujo típico

1. Buscar: busque propiedades turísticas por destino y fechas.
2. Disponibilidad: compruebe qué habitaciones están disponibles en una propiedad específica.
3. Precio — Confirma la tarifa final de la habitación seleccionada.
4. Reservar: cree una reserva utilizando la tarifa y el token confirmados.

Artículo siguiente: Cómo mantener y confirmar una reserva de resort