여행 API · v1
여정 전체를 기반으로 구축하세요
하나의 연동으로 두 가지 상품: 항공 API(운임 캘린더, 검색, 가격 확인, 부가 서비스, 주문, 발권, 취소)와 호텔 API(도시 또는 호텔 코드로 검색, 객실, 요금 확인, 예약, 취소), 그리고 정적 콘텐츠. HTTPS 기반의 깔끔한 JSON, 서명된 요청, 샌드박스와 프로덕션에 공통인 하나의 기본 URL.
기본 URL
https://api.dubaitrip.com/v1샌드박스와 프로덕션에 하나의 URL — 키가 결정합니다. dt_sbx_ 키는 공급사의 테스트 시스템에, dt_live_ 키는 실제 재고에 연결됩니다.
가이드
- 빠른 시작가입부터 샌드박스에서의 항공권 예약까지, 다섯 단계로.
- 인증두 가지 인증 방식이 있으며 둘 다 키 ID에 연결됩니다: 서명된 요청(권장) 또는 OAuth 2 client-credentials Bearer 토큰.
- 환경, 한도, 버전 관리샌드박스와 프로덕션에 하나의 기본 URL을 사용하며, 서명에 사용한 키가 환경을 결정합니다.
- 오류모든 실패는 안정적인 기계 판독용 코드가 포함된 RFC 7807 문제 문서로 반환됩니다.
- 항공 API운임 캘린더, 900+ 항공사 검색, 오퍼 가격 확인, 부가 서비스 추가, 주문 생성, 발권, 환불 견적 및 처리.
- 호텔 API도시 코드(IATA 방식, 예: DXB) 또는 카탈로그에서 저장해 둔 호텔 코드로 1.5M+ 숙소를 검색하고, 식사 조건과 취소 정책이 포함된 객실 단위 요금을 조회한 뒤 검증하고 예약하며, 정책에 따라 취소하세요.
- 정적 콘텐츠검색 UI 구축과 도시별 호텔 카탈로그 저장을 위한 참조 데이터 조회: 공항, 항공사, 도시, 호텔.
- 변경 로그여행 API의 모든 변경 사항을 최신순으로 정리했습니다.
엔드포인트
인증
계정
항공
- 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.
호텔
- 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.
콘텐츠
- 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`.