Cómo obtener detalles, comodidades y accesibilidad de la propiedad del resort
Después de identificar una propiedad turística en los resultados de búsqueda, puede recuperar información detallada sobre ella. La API de Resorts proporciona dos puntos finales relacionados: uno para detalles generales de la propiedad y otro para categorías de instalaciones específicas.
Punto final de detalles de propiedad
GET {{apihost}}/resorts/api/v2/property/{propertyid}
Encabezados requeridos
| Encabezado | Valor | Requerido |
|---|---|---|
x-api-key | Su clave API | Sí |
x-correlation-id | Identificador de correlación único | Sí |
Accept-Language | Código de idioma (por ejemplo, en-US, es-ES) | No |
Parámetros de ruta
| Parámetro | Tipo | Requerido | Descripción |
|---|---|---|---|
property_id | cadena | Sí | El ID de propiedad devuelto por el punto final de búsqueda |
Solicitud de ejemplo
GET {{api_host}}/resorts/api/v2/property/RST-98765
Ejemplo de respuesta
JSON
{
"status": 200,
"data": {
"name": "Oceanfront Paradise Resort & Spa",
"checkin": "16:00",
"checkout": "11:00",
"address": {
"line_1": "100 Beachfront Drive",
"city": "Kailua-Kona",
"state": "HI",
"country": "US",
"postal_code": "96740"
},
"images": [
"https://images.example.com/resort-main.jpg",
"https://images.example.com/resort-pool.jpg",
"https://images.example.com/resort-room.jpg"
],
"location": {
"lat": 19.64,
"lon": -155.9969
},
"policies": {
"cancellation": "Free cancellation up to 72 hours before check-in.",
"pets": "No pets allowed.",
"smoking": "Non-smoking property."
},
"ratings": {
"star_rating": 4,
"user_rating": 8.7
},
"region": "aGF3YWlp",
"supplySource": "direct"
}
}Campos de respuesta
| Campo | Tipo | Descripción |
|---|---|---|
name | cadena | Nombre para mostrar de la propiedad |
checkin | cadena | Hora de check-in más temprana (formato de 24 horas) |
checkout | cadena | Última hora de salida (formato de 24 horas) |
address | objeto | Dirección completa de la propiedad |
images | matriz | Matriz de URL de imágenes para la propiedad |
location | objeto | Latitud y longitud de la propiedad |
policies | objeto | Políticas de propiedad (cancelación, mascotas, fumadores, etc.) |
ratings | objeto | Calificación de estrellas y calificación promedio de usuario |
region | cadena | Código de región a la que pertenece la propiedad |
supplySource | cadena | Identificador de fuente de suministro de inventario |
Localización
Para recibir detalles de la propiedad en un idioma específico, incluya el encabezado Accept-Language con un código de idioma válido. Por ejemplo:
Accept-Language: es-ES
No todas las propiedades admiten todos los idiomas. Si el idioma solicitado no está disponible, la API devuelve el contenido predeterminado en inglés.
Punto final de instalaciones
Utilice el mismo punto final de propiedad con un parámetro de consulta facility para recuperar categorías de instalaciones específicas.
GET {{apihost}}/resorts/api/v2/property/{propertyid}?facility={facility_type}
Tipos de instalaciones
| Valor | Descripción |
|---|---|
accessibilities | Características de accesibilidad y alojamiento |
airports | Aeropuertos cercanos con información a distancia |
amenities | Servicios dentro y fuera del sitio |
Accesibilidades
GET {{api_host}}/resorts/api/v2/property/RST-98765?facility=accessibilities
Ejemplo de respuesta
JSON
{
"status": 200,
"data": {
"features": [
"Wheelchair-accessible parking",
"Roll-in shower",
"Accessible bathroom"
],
"elevator": true,
"equipmentForDeaf": true,
"braileOrRaisedSignage": false
}
}Campos de accesibilidad
| Campo | Tipo | Descripción |
|---|---|---|
features | matriz | Lista de funciones de accesibilidad específicas disponibles |
elevator | booleano | Si la propiedad tiene acceso por ascensor |
equipmentForDeaf | booleano | Si hay equipos disponibles para huéspedes sordos o con problemas de audición |
braileOrRaisedSignage | booleano | Si hay disponible braille o señalización en relieve |
Aeropuertos
GET {{api_host}}/resorts/api/v2/property/RST-98765?facility=airports
Ejemplo de respuesta
JSON
{
"status": 200,
"data": [
{
"name": "Ellison Onizuka Kona International Airport",
"code": "KOA",
"distanceinmiles": 8.2,
"distanceinkms": 13.2
},
{
"name": "Hilo International Airport",
"code": "ITO",
"distanceinmiles": 78.5,
"distanceinkms": 126.3
}
]
}Campos del aeropuerto
| Campo | Tipo | Descripción |
|---|---|---|
name | cadena | Nombre completo del aeropuerto |
code | cadena | Código de aeropuerto IATA |
distanceinmiles | número | Distancia desde la propiedad en millas |
distanceinkms | número | Distancia desde la propiedad en kilómetros |
Servicios
GET {{api_host}}/resorts/api/v2/property/RST-98765?facility=amenities
Ejemplo de respuesta
JSON
{
"status": 200,
"data": [
{
"name": "Swimming Pool",
"proximity": "Onsite",
"group_type": "Recreation",
"distances": null
},
{
"name": "Full-Service Spa",
"proximity": "Onsite",
"group_type": "Wellness",
"distances": null
},
{
"name": "Golf Course",
"proximity": "Offsite",
"group_type": "Recreation",
"distances": {
"miles": 2.5,
"kms": 4
}
}
]
}Campos de servicios
| Campo | Tipo | Descripción |
|---|---|---|
name | cadena | Nombre del servicio |
proximity | cadena | "Onsite" o "Offsite" |
group_type | cadena | Agrupación de categorías (p. ej., recreación, bienestar, gastronomía) |
distances | objeto o nulo | Información de distancia para servicios fuera del sitio. null para servicios en el lugar. |
Mejores prácticas
- Detalles de la propiedad en caché: los detalles de la propiedad (nombre, dirección, imágenes, políticas) cambian con poca frecuencia. Almacene en caché estas respuestas para reducir las llamadas a la API y mejorar el rendimiento.
- Buscar instalaciones a pedido: solo solicite tipos de instalaciones específicos cuando el usuario los necesite, en lugar de buscar las tres categorías por adelantado.
- Mostrar accesibilidad claramente: muestre la información de accesibilidad de manera destacada para los huéspedes que la necesiten. Utilice los campos booleanos para un filtrado rápido y la matriz
featurespara una visualización detallada. - Mostrar el aeropuerto más cercano: utilice los datos de las instalaciones del aeropuerto para ayudar a los huéspedes a planificar su viaje. Ordene por distancia para resaltar la opción más conveniente.
Artículo siguiente: Cómo comprobar la disponibilidad y el precio de las habitaciones