API de referencias de contenido
La API de referencias de contenido te ayuda a entender mejor el contenido de los alojamientos de Rapid.
La información sobre el alojamiento (incluidas las comodidades o servicios disponibles en el propio alojamiento o en las habitaciones, los valor añadidos y las comodidades incluidas en la tarifa) que se ofrece en las API de Rapid Content se identifica mediante identificadores numéricos. Usa la API de referencias de contenido para self-serve consultar listas de identificadores de atributos y sus significados.
Datos de referencia
Servicios
Las comodidades son las características o servicios que tienen a su disposición los viajeros.
En las API de Rapid Content, proporcionamos el « id », el « name » (localizado) y el « value » (explícito) (cuando corresponda) de cada servicio dentro del objeto « amenities ».
Los servicios están disponibles a nivel de alojamiento, habitación y plan de tarifas, y están incluidos, a no ser que se especifique que existe un recargo o una restricción.
- Nivel del alojamiento: Servicios disponibles para todos los viajeros.
- Nivel de habitación: los servicios se aplican solamente a la habitación asociada.
- Nivel de plan de tarifas: los servicios se aplican solamente al plan de tarifas asociado.
Busca los objetos « amenities_property », « amenities_rooms » y « amenities_rates ».
Cada servicio tiene 3 campos:
idnamehas_value
Ejemplo de respuesta de la API de contenido:
"amenities": {
"9": {
"id": 9,
"name": "Fitness facilities"
},
"2820": {
"id": 2820,
"name": "Number of indoor pools -",
"value": 10
}
},Categorías de servicios
Las categorías de servicios permiten la agrupación de servicios relacionados para que puedan visualizarse, buscarse o usarse como filtros.
En las API de Rapid Content, el objeto « categories » describe la categoría a la que pertenece un servicio. Esto te permite agrupar más fácilmente los servicios relacionados para mostrarlos, buscarlos o filtrarlos.
Ejemplo de respuesta de la API de contenido:
{
"12345": {
"property_id": "12345",
...
"amenities": {
"2070": {
"id": "2070",
"name": "Dry cleaning/laundry service",
"categories": [
"drycleaning_and_laundry_services"
]
}
}
}
}Categorías disponibles
accessibilityaccessible_parkingaccessible_wheelchairair_conditioningairport_transferall_inclusivebarcasinocribdry_cleaning_laundrydryerelectric_charging_stationfree_airport_transferfree_all_mealsfree_breakfastfree_breakfast_1_or_2_guestsfree_dinnerfree_lunchfree_wifigymhot_tubkitchenmeeting_facilityocean_viewparkingpets_allowedspa_servicesswimming_poolwasherwater_parkwifi
Atributos
Los atributos representan las políticas y características aplicables al alojamiento y la estancia.
En las API de Rapid Content, proporcionamos el valor « id », la versión localizada « name » y el valor explícito « value » (cuando corresponda) del atributo dentro del objeto « attributes ».
Los atributos están disponibles a nivel de alojamiento y representan las políticas y las funciones aplicables al alojamiento y a la estancia.
general: políticas generales que se aplican al alojamiento.pets: Normas sobre mascotas que se aplican a la vivienda.
Busca los objetos attributes_general y attributes_pets.
Cada atributo tiene 3 campos:
idnamehas_value
Ejemplo de respuesta de la API de contenido:
"attributes": {
"general": {
"2549": {
"id": 2549,
"name": "No elevators"
},
"3357": {
"id": 3357,
"name": "Caters to adults only"
}
},
"pets": {
"51": {
"id": 51,
"name": "Pets allowed"
},
"2809": {
"id": 2809,
"name": "Dogs only"
}
}
},Categoría
Cada alojamiento está asociado a una única categoría que representa el tipo de alojamiento.
En las API de Rapid Content, ofrecemos tanto « id » como « name » de la categoría «property» dentro del objeto « category ».
Cada alojamiento está asociado a una única categoría que representa el tipo de alojamiento que se ofrece.
Busca el objeto «category».
Cada categoría tiene 2 campos:
idname
Ejemplo de respuesta de la API de contenido:
"category": {
"id": 1,
"name": "Hotel"
},A continuación, se proporciona una lista de categorías de alojamientos para consultas rápidas.
id | name |
|---|---|
| 0 | Alojamiento |
| 1 | Hotel |
| 2 | Motel |
| 3 | Complejo turístico |
| 4 | Posada |
| 5 | Bed and breakfast |
| 6 | Casa de huéspedes |
| 7 | Condominio |
| 8 | Alojamiento todo incluido |
| 9 | Cabaña |
| 10 | Chalet |
| 11 | Casa de campo |
| 12 | Albergue juvenil |
| 13 | Rancho |
| 14 | Villa |
| 15 | Lodge |
| 16 | Apartamento |
| 17 | Casa vacacional privada |
| 18 | Casa barco |
| 20 | Ryokan |
| 21 | Casa en un árbol |
| 22 | Apartotel |
| 23 | Complejo de apartamentos |
| 24 | Camping |
| 25 | Riad |
| 26 | Hostal |
| 29 | Casa rural |
| 30 | Pensión |
| 31 | Pousada (Portugal) |
| 32 | Pousada (Brasil) |
| 33 | Residencia |
| 34 | Affittacamere |
| 36 | Castillo |
| 37 | Safari/tienda de campaña |
| 39 | Palacio |
| 40 | Alojamiento agroturístico |
| 41 | Crucero |
| 42 | Centro vacacional |
| 43 | Hotel cápsula |
| 44 | Casa móvil |
Referencias en cadena
Las cadenas de alojamientos representan una empresa matriz que puede tener varias marcas asociadas a ella.
En la API de Rapid Content, ofrecemos una tabla de correspondencias de todas las cadenas reconocidas.
Cada alojamiento está asociado a una única marca, que tiene una cadena principal.
Ejemplo de respuesta de la API de contenido:
"chain": {
"id": -6,
"name": "Hyatt Hotels"
},
"brand": {
"id": 2209,
"name": "Hyatt Place"
},Imágenes
Las imágenes están organizadas por categorías, en función de la zona del alojamiento que esté representada en la imagen.
En las API de Rapid Content, indicamos el ID de la categoría en el campo « category » y el nombre de la categoría en el campo « caption » para cada imagen del alojamiento. Las fotos de las habitaciones también tienen pies de foto.
Busca el objeto «images».
Cada categoría de imágenes tiene 2 campos:
idname
Ejemplo de respuesta de la API de contenido:
"images": [
{
"caption": "Featured Image",
"hero_image": true,
"category": 3,
"links": {
"350px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_b.jpg"
},
"70px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_t.jpg"
},
"1000px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_z.jpg"
}
}
},
]Tipos de pago en el alojamiento
Los tipos de pago en el alojamiento representan las formas de pago aceptadas con motivo de los cargos en los que se haya incurrido o que se le adeudan al alojamiento.
En las API de Rapid Content, ofrecemos la URL id y la versión localizada name de los tipos de pago en la propia página, dentro del objeto types, que se encuentra en el objeto onsite_payments.
Los tipos de pago en las instalaciones están disponibles a nivel de alojamiento y representan las formas de pago aceptadas con motivo de los cargos en los que se haya incurrido o que se deben al alojamiento.
Busca el objeto «onsite_payment_types».
Cada tipo de pago tiene dos campos:
idname
Ejemplo de respuesta de la API de contenido:
"onsite_payments": {
"currency": "USD",
"types": {
"171": {
"id": 171,
"name": "American Express"
}
}
},Estadísticas
Las estadísticas representan información a nivel de alojamiento, como el número de plantas o de habitaciones.
En las API de Rapid Content, proporcionamos el « id », el « name » (localizado) y el « value » (explícito, cuando corresponda) de la estadística dentro del objeto « statistics ».
Las estadísticas están disponibles a nivel de alojamiento y representan datos como el número de plantas y el número de habitaciones.
Busca el objeto «statistics».
Cada estadística tiene 3 campos:
idnamevalue
Ejemplo de respuesta de la API de contenido:
"statistics": {
"52": {
"id": 52,
"name": "Total number of rooms -",
"value": "820"
},
"54": {
"id": 54,
"name": "Number of floors -",
"value": "38"
}
},Temas
Los temas representan el tipo de viajero al que suelen dirigirse o el ambiente de un alojamiento.
En las API de Rapid Content, ofrecemos tanto la versión en inglés id como la versión localizada name del tema dentro del objeto themes.
Los temas están disponibles a nivel de alojamiento y representan el tipo de viajero al que suelen dirigirse o el ambiente de un alojamiento. Un alojamiento puede estar asociado a más de un tema, pero no todos tienen uno.
Busca el objeto « themes ».
Cada tema tiene 2 campos:
idname
Ejemplo de respuesta de la API de contenido:
"themes": {
"2337": {
"id": 2337,
"name": "Luxury Hotel"
},
"2341": {
"id": 2341,
"name": "Spa Hotel"
}
},Vistas de la habitación
Las vistas de la habitación representan las vistas disponibles desde una habitación determinada.
En las API de Rapid Content, ofrecemos la versión en inglés id y la versión localizada name de la vista, a las que se puede acceder desde el objeto views.
Busca el objeto «room_views ».
Cada vista tiene 2 campos:
idname
Ejemplo de respuesta de la API de contenido:
"views": {
"4146": {
"id": 4146,
"name": "Courtyard view"
}
},Idiomas hablados
Los idiomas que se hablan son los que habla el personal del alojamiento.
En las API de Rapid Content, proporcionamos el « id » y el nombre localizado del idioma que se habla a partir del objeto « spoken_languages ».
Busca el objeto «spoken_languages ».
Cada idioma tiene 2 campos:
idname
Ejemplo de respuesta de la API de contenido:
"spoken_languages": {
"vi": {
"id": "vi",
"name": "Vietnamese"
}
},