Búsqueda y filtrado de respuestas de la API de contenido
Busca y filtra fácilmente la respuesta de la API de contenido para obtener resultados más específicos.
Los colaboradores pueden utilizar la función de búsqueda y filtrado de contenido de Rapid para controlar la información sobre el alojamiento que reciben en la respuesta de contenido. Esto les permite simplificar sus datos desde Rapid y acceder solo a la información que necesitan para sus clientes, lo que supone una reducción de costes y una mayor flexibilidad.
Búsqueda
Busca alojamientos que ofrezcan un equipamiento o servicio en concreto a los huéspedes; por ejemplo, busca alojamientos que ofrezcan características de sostenibilidad.
Los colaboradores de Rapid pueden realizar búsquedas por elementos a nivel de alojamiento, por ejemplo:
category_id
: categoríasall_inclusive
: estado de todo incluidoattribute_id
: atributosamenity_id
: servicios a nivel de alojamientospoken_language_id
: idiomas hablados
Nota: Esta funcionalidad no incluye elementos específicos de los planes de tarifas o de las habitaciones.
Ejemplo de solicitud de Rapid 3: En este ejemplo utilizamos el nuevo parámetro de búsqueda amenity_id
para limitar los alojamientos que se devuelven en los resultados.
curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&amenity_id=115\
&include=property_id\
&property_id=1337\
&property_id=1" \
-H "accept: application/json, application/json"\
-H "accept-encoding: gzip"\
-H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
-H "user-agent: TravelNow/3.30.112"
Ejemplo de respuesta de Rapid 3: En esta respuesta, podemos ver que solo se devuelve como resultado el alojamiento 1337, ya que el alojamiento 1 no tiene disponible el identificador de servicio 115.
{
"1337": {
"property_id": "1337"
}
}
Para obtener una lista completa de los atributos, servicios, idiomas hablados y categorías disponibles, consulta las listas de referencia de contenido.
Filtrado
Solicita una parte de la respuesta de contenido de Rapid sin recibir todos los detalles del alojamiento. Los colaboradores pueden solicitar solo las secciones de nivel superior de la respuesta de la API de contenido que necesiten. Esto puede solicitarse mediante el parámetro include
y los resultados solo incluirán property_id
y las secciones solicitadas por alojamiento.
Las secciones disponibles para filtrar actualmente son las siguientes:
Nota: Esta lista no es exhaustiva, ya que la funcionalidad de filtrado también se aplicará a cualquier nueva sección de nivel superior que se añada en el futuro.
property_id
name
address
ratings
location
phone
fax
category
rank
business_model
checkin
checkout
fees
policies
attributes
amenities
images
onsite_payments
rooms
rates
dates
descriptions
statistics
airports
themes
all_inclusive
tax_id
chain
brand
spoken_languages
multi_unit
payment_registration_recommended
supply_source
vacation_rental_details
Ejemplo de solicitud de Rapid 3: En este ejemplo utilizamos los nuevos valores de name
y amenities
en el parámetro include
.
curl -X GET "https://test.ean.com/v3/properties/content\
?language=en-US\
&supply_source=expedia\
&include=name\
&include=amenities\
&property_id=1337" \
-H "accept: application/json, application/json"\
-H "accept-encoding: gzip"\
-H "authorization: EAN apikey=abcd1234,signature=090a77e7ddd7779980231,timestamp=1697664047"\
-H "user-agent: TravelNow/3.30.112"
Ejemplo de respuesta de Rapid 3: En esta respuesta, podemos ver que property_id
, name
y amenities
están incluidos en la respuesta. property_id
siempre se incluye en la respuesta, y no es necesario especificarlo como parámetro de la solicitud include
a menos que sea el único campo que se desee incluir en la respuesta. Nota: La lista de servicios aparece truncada para que el ejemplo sea conciso.
{
"1337": {
"property_id": "1337",
"name": "Hyatt Regency Paris Etoile",
"amenities": {
"8": {
"id": "8",
"name": "Elevator"
},
"43": {
"id": "43",
"name": "Concierge services"
},
"115": {
"id": "115",
"name": "Bicycle rentals nearby"
},
"361": {
"id": "361",
"name": "Breakfast available (surcharge)"
},
...
}
}
}