Busca e filtragem de respostas da API de conteúdo

Busque e filtre com facilidade a resposta da API de conteúdo para ter resultados mais específicos.

Parceiros podem usar a funcionalidade de busca e filtro de conteúdo da Rapid para controlar quais informações sobre a propriedade aparecem na resposta de conteúdo. Assim, é possível otimizar os dados da Rapid e acessar apenas as informações necessárias para os seus clientes, reduzindo os custos e aumentando a flexibilidade.

Busca

Busque propriedades que oferecem uma comodidade ou um serviço específico, como recursos de sustentabilidade.

Parceiros da Rapid podem buscar elementos no nível da propriedade, incluindo:

category_id: categorias
all_inclusive: status de tudo incluído
attribute_id: atributos
amenity_id - Comodidades no nível da propriedade
spoken_language_id - Línguas faladas

Observação: essa funcionalidade não inclui elementos específicos de quarto ou plano tarifário.

Exemplo de solicitação rápida 3:

Neste exemplo, estamos usando o novo parâmetro de pesquisa amenity_id para limitar quais propriedades são retornadas.

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"

Exemplo de resposta rápida 3:

Nesta resposta, podemos ver que apenas a propriedade 1337 é retornada porque a propriedade 1 não tem o ID de comodidade 115 disponível.

{
  "1337": {
    "property_id": "1337"
  }
}

Para consultar uma lista completa de atributos, comodidades, idiomas falados e categorias disponíveis, confira as listas de referência de conteúdo.

Filtrar

Solicite uma parte da resposta de conteúdo da Rapid sem receber todos os detalhes da propriedade. Parceiros podem solicitar apenas as seções de nível superior da resposta necessária da API de conteúdo. É possível fazer isso pelo parâmetro include, e os resultados vão incluir apenas property_id e as seções solicitadas por propriedade.

Confira abaixo as seções de filtragem disponíveis no momento.

Observação: esta lista não está completa, pois a funcionalidade de filtro também se vai aplicar a todas as novas seções de nível superior adicionadas no 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

Exemplo de solicitação rápida 3:

Neste exemplo, estamos usando os valores name e amenities no 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"

Exemplo de resposta rápida 3:

Aqui podemos ver que property_id, name e amenities estão incluídos na resposta. property_id é sempre incluído na resposta e não precisa ser especificado como um parâmetro de solicitação include, a menos que seja o único campo desejado na resposta. Observação: a lista de comodidades foi truncada para manter o exemplo 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)"
      },
      ...
    }
  }
}