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 alojamiento
• spoken_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)"
      },
      ...
    }
  }
}