API de viagens · v1
Construa sobre a viagem inteira
Uma integração, dois produtos: a API de Voos (calendário de tarifas, pesquisa, tarifação, serviços adicionais, encomenda, bilhete, cancelamento) e a API de Hotéis (pesquisa por cidade ou por códigos de hotel, quartos, verificação de tarifa, reserva, cancelamento), além de conteúdo estático. JSON limpo sobre HTTPS, pedidos assinados, um único URL base para sandbox e produção.
URL base
https://api.dubaitrip.com/v1Um único URL para sandbox e produção — a chave decide: as chaves dt_sbx_ acedem aos sistemas de teste dos nossos fornecedores, as chaves dt_live_ ao inventário real.
Guias
- Início rápidoDo registo a um voo reservado no sandbox, em cinco passos.
- AutenticaçãoDuas formas de autenticação, ambas associadas ao ID da sua chave: pedidos assinados (recomendado) ou tokens bearer OAuth 2 client-credentials.
- Ambientes, limites e controlo de versõesUm único URL base para sandbox e produção; a chave com que assina seleciona o ambiente.
- ErrosCada falha é um documento de problema RFC 7807 com um código estável legível por máquina.
- API de VoosCalendário de tarifas, pesquisa em 900+ companhias aéreas, tarifação de uma oferta, serviços adicionais, criação de encomendas, emissão de bilhetes, cotação e processamento de reembolsos.
- API de HotéisPesquise 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.
- Conteúdo estáticoConsultas de referência para construir uma interface de pesquisa e para guardar o nosso catálogo de hotéis por cidade: aeroportos, companhias aéreas, cidades e hotéis.
- Registo de alteraçõesTodas as alterações à API de viagens, das mais recentes para as mais antigas.
Endpoints
Autenticação
Conta
Voos
- get
/v1/flights/price-calendarCheapest fare per day for a route over a date window, from our price cache — instant and never a live supplier call. Draw a fare calendar before searching. Omit the return window for one-way prices. - post
/v1/flights/searchSearch flights. Returns a session to poll, or the complete result when `wait` is true. - get
/v1/flights/search/{searchId}Read the next page of a running search. `status` becomes `complete` when every supplier answered. - post
/v1/flights/offers/{offerId}/priceRe-price an offer right before booking. `priceChanged` tells you the total moved. - get
/v1/flights/offers/{offerId}/fare-rulesFare rules and conditions of an offer. - get
/v1/flights/offers/{offerId}/ancillariesChargeable extras available for an offer — today extra checked-baggage allowances, priced by the airline per passenger. Add them to the order via `ancillaries[]` on POST /v1/flights/orders. - post
/v1/flights/ordersCreate an order (hold) from an offer. Requires an `Idempotency-Key` header. - get
/v1/flights/orders/{orderId}Read an order: status, time limit, tickets. - post
/v1/flights/orders/{orderId}/issueIssue the tickets of a held order (charges your deposit balance). - get
/v1/flights/orders/{orderId}/refund-quoteWhat a cancellation would refund, before you commit. - post
/v1/flights/orders/{orderId}/cancelCancel: a held order is released; a ticketed order is voided inside the void window, else refunded. - get
/v1/flights/scheduleTimetable for a route on one day: which flights operate, with local times and equipment — no fares. Query: `origin`, `destination` (IATA), `date` (yyyy-MM-dd). - post
/v1/flights/orders/{orderId}/exchange/searchExchange step 1: search replacement itineraries for a ticketed order. Offers come back in the search shape and expire the same way. - post
/v1/flights/orders/{orderId}/exchange/quoteExchange step 2: what exchanging the listed tickets onto an offer would cost. No side effects. - post
/v1/flights/orders/{orderId}/exchangeExchange step 3: re-issue the listed tickets onto the offer (charges your deposit balance). Requires an `Idempotency-Key` header.
Hotéis
- post
/v1/hotels/searchSearch hotels by city code (IATA-style, e.g. DXB — see /v1/content/cities), by hotel codes from your stored catalogue, or by a geo circle. Returns a session to poll, or the complete result when `wait` is true. - get
/v1/hotels/search/{searchId}Read the next page of a running search. Pass the same dates and room count as the search so rate keys stay bookable. - get
/v1/hotels/{hotelCode}/roomsRoom types of a hotel. Pass any `rateKey` from the same search so the right supplier answers. - post
/v1/hotels/rates/{rateKey}/checkPre-book check: confirms the rate is still bookable and its price. - post
/v1/hotels/bookingsBook a rate. Requires an `Idempotency-Key` header. - get
/v1/hotels/bookings/{bookingId}Read a booking (voucher). - get
/v1/hotels/bookings/{bookingId}/cancellation-quoteWhat a cancellation would refund, before you commit. - post
/v1/hotels/bookings/{bookingId}/cancelCancel a booking under its cancellation policy.
Conteúdo
- get
/v1/content/airportsAirports (IATA), optionally filtered by a free-text term or a country. - get
/v1/content/citiesCities usable as a hotel search destination, optionally filtered by term or country. - get
/v1/content/airlinesAirlines (IATA two-letter codes). - get
/v1/content/hotelsLook up hotels by city and/or name — a lookup, not a catalogue export: a cityCode or a name of 3+ characters is required, 50 per page, 20 pages per query. Store the codes you need: availability is searched by `cityCode` or `hotelCodes`.