This is an auto-generated translation

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: Categorias
  • all_inclusive: All-inclusive status
  • attribute_id: Atributos
  • amenity_id: propriedade comodidades de nível
  • 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 1

Neste exemplo, estamos usando o novo parâmetro de pesquisa amenity_idpara 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 includepara especificar as seções desejadas. Os resultados consistirão nas seções property_ide 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 namee amenitiesno 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, namee amenitiesestã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)"
      },
      ...
    }
  }
}
Esta página foi útil?
Como podemos melhorar esse conteúdo?
Agradecemos por nos ajudar a melhorar.