Listas de referencias de contenido
Se ponen a tu disposición listas de referencias para ayudarte a entender mejor el contenido de los alojamientos.
La información que las API de contenido de Rapid facilitan sobre los alojamientos suele representarse mediante identificadores (ID). Usa estas listas de referencias para comprender el significado de esos ID.
API de referencias de contenido
Rapid ofrece la API de Referencias de Contenido como recurso para que los socios la utilicen cuando trabajen con información sobre inmuebles. Utilizar la API ofrece algunas ventajas claras respecto a utilizar la lista estática (ver más abajo), entre las que se incluyen:
- Los datos de referencia siempre estarán actualizados cuando se acceda a ellos a través de la API.
- Los datos de referencia localizados están disponibles a través de la API, mientras que la lista estática sólo está disponible en inglés.
Lista de referencia de contenido estático
Se proporciona un solo archivo JSON con todas las listas de referencias de contenido que se mencionan a continuación. Para obtener más información sobre cada lista individual y lo que se proporciona en el archivo JSON, haz clic en el nombre de la referencia de contenido. Las listas descargables solo están disponibles en inglés para consultas. Los nombres traducidos se devuelven en las API de contenido.
Descargar las listas de referencias
Fecha de la última actualización: 21 de octubre de 2024.
Servicios
Los servicios representan las características o prestaciones que los huéspedes tienen a su disposición.
En las API de contenido de Rapid, proporcionamos el id
, el name
traducido y el value
explícito (cuando corresponda) de cada servicio en el objeto de 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 de alojamiento: los servicios del alojamiento están disponibles para todos los huéspedes.
- 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.
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
}
},
Lista de referencias
Consulta el archivo con las listas de referencias de contenido que aparece arriba para ver los objetos de amenities_property
, amenities_rooms
y amenities_rates
.
Cada servicio contiene tres campos:
id
name
has_value
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 contenido de Rapid, el objeto categories
describe la categoría a la que pertenece un servicio. Esta opción facilita a los colaboradores la agrupación de servicios relacionados para que puedan visualizarse, buscarse o usarse como filtros.
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 |
---|
accessibility |
accessible_bathroom |
accessible_parking |
accessible_wheelchair |
air_conditioning |
airport_transfer |
all_inclusive |
bar |
casino |
crib |
dry_cleaning_laundry |
dryer |
electric_charging_station |
free_airport_transfer |
free_all_meals |
free_breakfast |
free_breakfast_1_or_2_guests |
free_dinner |
free_lunch |
free_wifi |
gym |
hot_tub |
kitchen |
meeting_facility |
ocean_view |
parking |
pets_allowed |
restaurant_in_hotel |
spa_services |
swimming_pool |
washer |
water_park |
wifi |
Atributos
Los atributos representan las políticas y características aplicables al alojamiento y la estancia.
En las API de contenido de Rapid, proporcionamos el id
, el name
traducido y el value
explícito (cuando corresponda) del atributo en el objeto de 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
: políticas de mascotas que se aplican al alojamiento.
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"
}
}
},
Lista de referencias
Consulta el archivo con las listas de referencias de contenido que aparece arriba para ver los objetos de attributes_general
y attributes_pets
.
Cada atributo contiene tres campos:
id
name
has_value
Categoría
Cada alojamiento está asociado a una única categoría que representa el tipo de alojamiento.
En las API de contenido de Rapid, proporcionamos tanto el id
como el name
de la categoría de alojamiento en el objeto de category
.
Cada alojamiento está asociado a una única categoría que representa el tipo de alojamiento que se ofrece.
Ejemplo de respuesta de la API de contenido:
"category": {
"id": 1,
"name": "Hotel"
},
Lista de referencias
A continuación, se proporciona una lista de categorías de alojamientos para consultas rápidas. También está disponible en el archivo de descarga.
ID | nombre |
---|---|
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 |
Consulta el archivo con las listas de referencias de contenido para ver el objeto de category
.
Cada categoría contiene dos campos:
id
name
API de cadena nueva
Las cadenas de alojamientos representan una empresa matriz que puede tener varias marcas asociadas a ella.
En la API de contenido de Rapid, proporcionamos una asignación de referencia con todas las cadenas que reconoce Rapid API.
No incluimos las cadenas ni las marcas en el archivo de referencia, ya que pueden cambiar con frecuencia. Te recomendamos que consultes la API de referencia para obtener la lista más reciente. Esta asignación se actualiza a diario.
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 contenido de Rapid, proporcionamos el ID de la categoría en el campo category
y el nombre de la categoría en el campo caption
de cada imagen del alojamiento. Las imágenes de habitaciones también tienen subtítulos.
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"
}
}
},
]
Lista de referencias
Consulta el archivo con las listas de referencias de contenido para ver el objeto de images
.
Cada categoría de imagen contiene dos campos:
id
name
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 contenido de Rapid, proporcionamos el id
y el name
traducido de los tipos de pago en las instalaciones en el objeto de types
, que se encuentra en el objeto de onsite_payments
.
Los tipos de pago en el alojamiento 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.
Ejemplo de respuesta de la API de contenido:
"onsite_payments": {
"currency": "USD",
"types": {
"171": {
"id": 171,
"name": "American Express"
}
}
},
Lista de referencias
Consulta el archivo con las listas de referencias de contenido que aparece arriba para ver el objeto de onsite_payment_types
.
Cada tipo de pago contiene dos campos:
id
name
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 contenido de Rapid, proporcionamos el id
, el name
traducido y el value
explícito (cuando corresponda) de la estadística en el objeto de 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.
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"
}
},
Lista de referencias
Consulta el archivo con las listas de referencias de contenido para ver el objeto de statistics
.
Cada estadística contiene tres campos:
id
name
value
Temas
Los temas representan el tipo de viajero al que suelen dirigirse o el ambiente de un alojamiento.
En las API de contenido de Rapid, proporcionamos tanto el id
como el name
traducido del tema en el objeto de 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.
Ejemplo de respuesta de la API de contenido:
"themes": {
"2337": {
"id": 2337,
"name": "Luxury Hotel"
},
"2341": {
"id": 2341,
"name": "Spa Hotel"
}
},
Lista de referencias
Consulta el archivo con las listas de referencias de contenido que aparece arriba para ver el objeto de themes
.
Cada tema contiene dos campos:
id
name
Vistas de la habitación
Las vistas de la habitación representan las vistas disponibles desde una habitación determinada.
En las API de contenido de Rapid, proporcionamos tanto el id
como el name
traducido de la vista disponible desde el objeto de views
.
Ejemplo de respuesta de la API de contenido:
"views": {
"4146": {
"id": 4146,
"name": "Courtyard view"
}
},
Lista de referencias
Consulta el archivo con las listas de referencias de contenido que aparece arriba para ver room_views
.
Cada vista contiene dos campos:
id
name
Idiomas hablados
Los idiomas hablados representan los idiomas que se hablan en el alojamiento.
En las API de contenido de Rapid, proporcionamos tanto el ID como el nombre traducido del idioma que se habla en el objeto de spoken_languages
.
Ejemplo de respuesta de la API de contenido:
"spoken_languages": {
"vi": {
"id": "vi",
"name": "Vietnamese"
}
},
Lista de referencias
Consulta el archivo con las listas de referencias de contenido para ver spoken_languages
.
Cada idioma contiene dos campos:
id
name