Pesquisa e filtragem
Pesquise e filtre facilmente a resposta da Rapid Content API para obter resultados mais direcionados.
Você pode usar a funcionalidade de pesquisa e filtragem da Rapid Content API para controlar quais informações propriedade você recebe na resposta. Isso permite que você simplifique os dados recebidos e acesse apenas as informações que os viajantes precisam, o que significa redução de custos e mais flexibilidade.
Buscar
Use a funcionalidade de pesquisa para encontrar propriedades que oferecem uma comodidade ou serviço específico aos hóspedes, por exemplo, propriedades que oferecem recursos aprimorados de sustentabilidade.
Você pode pesquisar por elementos property-level, incluindo:
category_id
: Categoriasall_inclusive
: All-inclusive statusattribute_id
: Atributosamenity_id
: propriedade comodidades de nívelspoken_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 1
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 1
Nesta resposta, podemos ver que apenas propriedade 1337 é retornado porque propriedade 1 não tem o ID de comodidade 115 disponível.
{
"1337": {
"property_id": "1337"
}
}
Para uma lista completa de atributos, comodidades, idiomas falados e categorias disponíveis, consulte as listas de referência de conteúdo.
Filtrar
Você pode solicitar uma parte da resposta sem receber detalhes completos do propriedade, solicitando apenas as seções top-level necessárias. Use o parâmetro include
para especificar as seções desejadas. Os resultados consistirão nas seções property_id
e solicitadas por propriedade.
Seções disponíveis para filtragem
Observação: esta lista não deve ser considerada exaustiva, pois a funcionalidade do filtro também se aplicará a quaisquer novas seções top-level 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 2
Neste exemplo, estamos usando os valores name
e amenities
no parâmetroinclude
.
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 2
Este exemplo mostra que property_id
, name
e amenities
estão incluídos na resposta. Observação: property_id
é sempre incluído na resposta; você não precisa especificá-lo como um parâmetro include
, a menos que seja o único campo desejado.
{
"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)"
},
...
}
}
}