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ías
all_inclusive: estado de todo incluido
attribute_id: atributos
amenity_id - Servicios a nivel de propiedad
spoken_language_id - Lenguas habladas

Nota: Esta funcionalidad no incluye elementos específicos de los planes de tarifas o de las habitaciones.

Ejemplo de solicitud rápida 3:

En este ejemplo estamos utilizando el nuevo parámetro de búsqueda amenity_id para limitar qué propiedades se devuelven.

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 rápida 3:

En esta respuesta podemos ver que sólo se devuelve la propiedad 1337 porque la propiedad 1 no tiene el identificador de amenidad 115 disponible.

{
  "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 rápida 3:

En este ejemplo estamos utilizando los valores 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 rápida 3:

Aquí podemos ver que property_id, name, y amenities se incluyen en la respuesta. property_id se incluye siempre en la respuesta y no es necesario especificarlo como parámetro de la petición a menos que sea un parámetro de la petición. 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. único campo deseado en la respuesta. Nota: lista de servicios 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)"
      },
      ...
    }
  }
}