API de Hotéis
Pesquise 1.5M+ alojamentos por código de cidade (estilo IATA, p. ex. DXB) ou pelos códigos de hotel que guarda a partir do nosso catálogo, consulte tarifas ao nível do quarto com regime de alimentação e política de cancelamento, valide e reserve, e cancele segundo a política.
Pesquisa
POST /v1/hotels/search with a destination and check-in/out dates and one to eight rooms (adults and child ages per room). The destination is a cityCode (IATA-style, e.g. "DXB" — GET /v1/content/cities lists them), a list of hotelCodes from the catalogue you store on your side (GET /v1/content/hotels per city), or a geo circle. Name matching is yours to do against your stored list; availability is always asked by code.
Com wait=true obtém o conjunto completo de resultados; com wait=false, um searchId para consultar com GET /v1/hotels/search/{searchId} — passe as mesmas datas e o mesmo número de quartos para que as chaves de tarifa continuem reserváveis. Cada hotel traz o seu conteúdo (nome, estrelas, morada, geolocalização, imagem principal, instalações) e a tarifa mais barata por quarto com uma rateKey opaca, o total e os preços por noite, o regime, a possibilidade de reembolso e o prazo de cancelamento.
Quartos e tarifas
GET /v1/hotels/{hotelCode}/rooms?rateKey=… lista todos os tipos de quarto e tarifas de um alojamento para a estadia pesquisada: tipos de cama, ocupação, regime, políticas, impostos e taxas discriminados, e se a tarifa é reembolsável.
Verificação de tarifa
POST /v1/hotels/rates/{rateKey}/check confirma que a tarifa ainda é reservável e devolve o preço e a política finais. Faça-o imediatamente antes de reservar: um 409 price_changed ou rate_expired aqui sai muito mais barato do que uma reserva falhada.
Reservar
POST /v1/hotels/bookings com a rateKey, o titular, os hóspedes por quarto e um contacto, além de uma Idempotency-Key. A resposta é a reserva com a sua referência, a confirmação do fornecedor e os dados do voucher. GET /v1/hotels/bookings/{bookingId} devolve-a novamente a qualquer momento.
Cancelar
GET /v1/hotels/bookings/{bookingId}/cancellation-quote devolve a penalização segundo a política nesse momento; POST /v1/hotels/bookings/{bookingId}/cancel (Idempotency-Key obrigatória) confirma o cancelamento.