سفری 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+ ایئر لائنز میں تلاش، پیشکش کی قیمت، اضافی خدمات، آرڈر بنانا، ٹکٹ جاری کرنا، رقم واپسی کا تخمینہ اور کارروائی۔
- ہوٹل API1.5M+ پراپرٹیز کو شہر کے کوڈ (IATA طرز، مثلاً DXB) یا ہمارے کیٹلاگ سے محفوظ کیے گئے ہوٹل کوڈز کے ذریعے تلاش کریں، کھانے کے پلان اور منسوخی کی پالیسی کے ساتھ کمرے کی سطح کے نرخ دیکھیں، تصدیق کر کے بک کریں، اور پالیسی کے مطابق منسوخ کریں۔
- جامد موادتلاش کا انٹرفیس بنانے اور ہمارے ہوٹل کیٹلاگ کو شہر کے لحاظ سے محفوظ کرنے کے لیے حوالہ جاتی ڈیٹا: ہوائی اڈے، ایئر لائنز، شہر اور ہوٹل۔
- تبدیلیوں کا ریکارڈسفری 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`.