API de Referências de Conteúdo
A API de Referências de Conteúdo ajuda você a entender melhor o conteúdo do Rapid propriedade.
As informações sobre propriedade (incluindo comodidades ou serviços disponíveis em propriedade ou no nível do quarto, valores adicionais e benefícios da tarifa) fornecidas nas APIs de Conteúdo Rápido são representadas por IDs numéricos. Use a API de Referências de Conteúdo para obter listas de IDs de atributos e seus significados.
Detalhes de referência
Comodidades
As comodidades representam as características ou serviços disponíveis para os viajantes.
Nas APIs de Conteúdo Rápido, fornecemos o id, o name localizado e o value explícito (quando aplicável) de cada comodidade dentro do objeto amenities.
As comodidades estão disponíveis nos níveis de propriedade, quarto e plano tarifário e são grátis, a menos que uma sobretaxa ou restrição seja especificada.
- Nível propriedade: Comodidades disponíveis para todos os viajantes.
- Nível de quarto: as comodidades se aplicam apenas ao quarto associado.
- Nível de tarifa: as comodidades se aplicam apenas ao plano tarifário associado.
Procure os objetos amenities_property, amenities_rooms e amenities_rates.
Cada comodidade contém 3 campos:
idnamehas_value
Exemplo de resposta da API de conteúdo:
"amenities": {
"9": {
"id": 9,
"name": "Fitness facilities"
},
"2820": {
"id": 2820,
"name": "Number of indoor pools -",
"value": 10
}
},Categorias de comodidade
Com as categorias, é possível agrupar comodidades para exibição, pesquisa ou filtragem.
Nas APIs de Conteúdo Rápido, o objeto categories descreve a categoria na qual uma comodidade se encaixa. Isso permite agrupar mais facilmente comodidades relacionadas para exibição, pesquisa ou filtragem.
Exemplo de resposta da API de conteúdo:
{
"12345": {
"property_id": "12345",
...
"amenities": {
"2070": {
"id": "2070",
"name": "Dry cleaning/laundry service",
"categories": [
"drycleaning_and_laundry_services"
]
}
}
}
}Categorias disponíveis
accessibilityaccessible_parkingaccessible_wheelchairair_conditioningairport_transferall_inclusivebarcasinocribdry_cleaning_laundrydryerelectric_charging_stationfree_airport_transferfree_all_mealsfree_breakfastfree_breakfast_1_or_2_guestsfree_dinnerfree_lunchfree_wifigymhot_tubkitchenmeeting_facilityocean_viewparkingpets_allowedspa_servicesswimming_poolwasherwater_parkwifi
Atributos
Os atributos representam políticas e recursos que se aplicam às propriedades e à estadia.
Nas APIs de Conteúdo Rápido, fornecemos o id, o name localizado e o value explícito (quando aplicável) do atributo dentro do objeto attributes.
Atributos estão disponíveis na propriedade e representam políticas e recursos que se aplicam às propriedades e à estadia.
general: políticas gerais que se aplicam à propriedade.petsPol íticas para animais de estimação que se aplicam ao propriedade.
Procure os objetos attributes_general e attributes_pets.
Cada atributo contém 3 campos:
idnamehas_value
Exemplo de resposta da API de conteúdo:
"attributes": {
"general": {
"2549": {
"id": 2549,
"name": "No elevators"
},
"3357": {
"id": 3357,
"name": "Caters to adults only"
}
},
"pets": {
"51": {
"id": 51,
"name": "Pets allowed"
},
"2809": {
"id": 2809,
"name": "Dogs only"
}
}
},Categoria
Cada propriedade está associada a apenas uma categoria que representa o seu tipo.
Nas APIs de conteúdo rápido, fornecemos tanto id quanto name da categoria propriedade dentro do objeto category.
Cada propriedade está associada a apenas uma categoria de propriedade que representa o tipo de propriedade que está sendo oferecida.
Procure o objeto category.
Cada categoria contém 2 campos:
idname
Exemplo de resposta da API de conteúdo:
"category": {
"id": 1,
"name": "Hotel"
},Você pode consultar a lista de categorias de propriedades abaixo para uma rápida referência.
id | name |
|---|---|
| 0 | Propriedade |
| 1 | Hotel |
| 2 | Motel |
| 3 | Resort |
| 4 | Pousada |
| 5 | Bed and Breakfast |
| 6 | Guesthouse |
| 7 | Condomínio |
| 8 | Propriedade com tudo incluído |
| 9 | Cabana |
| 10 | Chalé |
| 11 | Casa de campo |
| 12 | Hostel |
| 13 | Rancho |
| 14 | Vila |
| 15 | Lodge |
| 16 | Apartamento |
| 17 | Casa de temporada privada |
| 18 | Casa flutuante |
| 20 | Ryokan |
| 21 | Casa na árvore |
| 22 | Apart-hotel |
| 23 | Resort condomínio |
| 24 | Área de acampamento |
| 25 | Riad |
| 26 | Dormitório |
| 29 | Chácara |
| 30 | Pensão |
| 31 | Pousada (Portugal) |
| 32 | Pousada (Brasil) |
| 33 | Residence |
| 34 | Affittacamere |
| 36 | Castelo |
| 37 | Safári/Tentalow |
| 39 | Palácio |
| 40 | Hotel-fazenda |
| 41 | Cruzeiro |
| 42 | Parque de férias |
| 43 | Hotel-cápsula |
| 44 | Trailer |
Referências em cadeia
As redes de propriedades representam uma empresa principal que pode ter várias marcas associadas a ela.
Na API de Conteúdo Rápido, fornecemos um mapeamento de referência de todas as cadeias reconhecidas.
Cada propriedade está associada a apenas uma marca, que possui uma rede hoteleira principal.
Exemplo de resposta da API de conteúdo:
"chain": {
"id": -6,
"name": "Hyatt Hotels"
},
"brand": {
"id": 2209,
"name": "Hyatt Place"
},Imagens
As imagens são organizadas com base na região da propriedade mostrada na imagem.
Nas APIs de Conteúdo Rápido, fornecemos o ID da categoria no campo category e o nome da categoria no campo caption para cada imagem propriedade. As imagens dos ambientes também possuem legendas.
Procure o objeto images.
Cada categoria de imagem contém 2 campos:
idname
Exemplo de resposta da API de conteúdo:
"images": [
{
"caption": "Featured Image",
"hero_image": true,
"category": 3,
"links": {
"350px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_b.jpg"
},
"70px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_t.jpg"
},
"1000px": {
"method": "GET",
"href": "https://i.travelapi.com/hotels/1000000/10000/100/1/5a329959_z.jpg"
}
}
},
]Formas de pagamento no local
As formas de pagamento no local representam os tipos de pagamento aceitos para cobranças incorridas ou devidas na propriedade.
Nas APIs de conteúdo rápido, fornecemos o id e o name localizado dos tipos de pagamento no site dentro do objeto types, que está no objeto onsite_payments.
As formas de pagamento no local estão disponíveis no nível da propriedade e representam os tipos de pagamento aceitos para cobranças incorridas ou devidas na propriedade.
Procure o objeto onsite_payment_types.
Cada tipo de pagamento contém 2 campos:
idname
Exemplo de resposta da API de conteúdo:
"onsite_payments": {
"currency": "USD",
"types": {
"171": {
"id": 171,
"name": "American Express"
}
}
},Estatísticas
As estatísticas representam as informações sobre a propriedade, como o número de andares ou de quartos.
Nas APIs de Conteúdo Rápido, fornecemos o id, o name localizado e o value explícito (quando aplicável) da estatística dentro do objeto statistics.
As estatísticas estão disponíveis no nível da propriedade e representam dados como o número de andares e de quartos.
Procure o objeto statistics.
Cada estatística contém 3 campos:
idnamevalue
Exemplo de resposta da API de conteúdo:
"statistics": {
"52": {
"id": 52,
"name": "Total number of rooms -",
"value": "820"
},
"54": {
"id": 54,
"name": "Number of floors -",
"value": "38"
}
},Temas
Os temas representam o tipo de viajante a ser alcançado ou o ambiente de uma propriedade.
Nas APIs de Conteúdo Rápido, fornecemos tanto o id quanto o name localizado do tema dentro do objeto themes.
Os temas estão disponíveis no nível da propriedade e representam o tipo de viajante a ser alcançado ou o ambiente de uma propriedade. Um propriedade pode estar associado a mais de um tema, mas nem todas as propriedades possuem um tema.
Procure o objeto themes.
Cada tema contém 2 campos:
idname
Exemplo de resposta da API de conteúdo:
"themes": {
"2337": {
"id": 2337,
"name": "Luxury Hotel"
},
"2341": {
"id": 2341,
"name": "Spa Hotel"
}
},Vistas do quarto
As vistas do quarto representam a vista disponível de um quarto.
Nas APIs de Conteúdo Rápido, fornecemos o id e o name localizado da visualização disponível no objeto views.
Procure o objeto room_views.
Cada visualização contém 2 campos:
idname
Exemplo de resposta da API de conteúdo:
"views": {
"4146": {
"id": 4146,
"name": "Courtyard view"
}
},Idiomas falados
Os idiomas falados representam os idiomas falados pela equipe do propriedade.
Nas APIs de Conteúdo Rápido, fornecemos o id e o nome localizado do idioma falado a partir do objeto spoken_languages.
Procure o objeto spoken_languages.
Cada idioma contém 2 campos:
idname
Exemplo de resposta da API de conteúdo:
"spoken_languages": {
"vi": {
"id": "vi",
"name": "Vietnamese"
}
},