क्विक स्टार्ट

1. सैंडबॉक्स क्रेडेंशियल पाएँ

ट्रैवल API पेज पर पंजीकरण करें। ईमेल सत्यापित होते ही आपका पार्टनर खाता बन जाता है और स्क्रीन पर एक सैंडबॉक्स कुंजी ID दिखाई जाती है; सीक्रेट उसी पते पर भेजे गए एक बार इस्तेमाल होने वाले लिंक से दिया जाता है। इसे अपने सीक्रेट्स मैनेजर में रखें — यह ठीक एक बार दिखाया जाता है।

आपको डेवलपर पोर्टल के लिए एक अस्थायी पासवर्ड भी मिलता है, जहाँ आप कुंजियाँ बना और रोटेट कर सकते हैं, IP अनुमति-सूची सेट कर सकते हैं, उपयोग देख सकते हैं और प्रोडक्शन का अनुरोध कर सकते हैं।

2. हर अनुरोध पर हस्ताक्षर करें

हर कॉल में चार हेडर होते हैं: X-API-Key (आपकी कुंजी ID), X-Timestamp (unix सेकंड), X-Nonce (16–128 यादृच्छिक वर्ण) और X-Signature — एक कैनॉनिकल स्ट्रिंग का lowercase hex HMAC-SHA256, जिसकी कुंजी आपका सीक्रेट है।

कैनॉनिकल स्ट्रिंग न्यूलाइन से जुड़ी पाँच पंक्तियाँ होती है: बड़े अक्षरों में HTTP मेथड, पाथ और क्वेरी स्ट्रिंग ठीक वैसे जैसे भेजी गई, टाइमस्टैम्प, nonce, और raw बॉडी का lowercase hex SHA-256 (खाली बॉडी का हैश शून्य बाइट्स का SHA-256 होता है)। टाइमस्टैम्प हमारी घड़ी से 300 सेकंड के भीतर होने चाहिए; एक nonce 10 मिनट के भीतर केवल एक बार इस्तेमाल हो सकता है।

POST
/v1/flights/search
1763200000
Qm9vdGxlZ0Zha2VOb25jZQ
3b0c44298fc1c149afbf4c8996fb92427ae41e4649b934ca495991b7852b855

3. अपनी पहली कॉल करें

सैंडबॉक्स पर एक फ़्लाइट खोजें। सैंडबॉक्स हमारे आपूर्तिकर्ताओं के टेस्ट एनवायरनमेंट से जुड़ा है, इसलिए खोज में टेस्ट इन्वेंटरी और कीमतें मिलती हैं, और वहाँ की गई बुकिंग एक टेस्ट बुकिंग होती है — कोई असली टिकट नहीं, कोई शुल्क नहीं। हर रेफ़रेंस पेज पर cURL, Node.js, Python और PHP में पूरा नमूना है — उसे कॉपी करें, अपनी कुंजी ID और सीक्रेट भरें, और चलाएँ।

curl -X POST "https://api.dubaitrip.com/v1/flights/search" \
  -H "X-API-Key: $KEY_ID" -H "X-Timestamp: $TS" -H "X-Nonce: $NONCE" -H "X-Signature: $SIG" \
  -H "Content-Type: application/json" \
  -d '{"slices":[{"origin":"DXB","destination":"LHR","departureDate":"2026-11-15"}],"passengers":{"adults":1},"wait":true}'

4. बुकिंग फ़्लो पूरा करें

उड़ानें: खोज → चुने गए ऑफ़र का मूल्य निर्धारण → यात्रियों और संपर्क के साथ ऑर्डर बनाना → टिकट जारी करना → (वैकल्पिक रूप से) रिफ़ंड का कोटेशन लेना और रिफ़ंड का अनुरोध करना। होटल: खोज → किसी प्रॉपर्टी के कमरे पढ़ना → दर जाँचना → बुकिंग बनाना → (वैकल्पिक रूप से) कोटेशन लेना और रद्द करना।

ऑफ़र ID और दर कुंजियाँ अपारदर्शी और अल्पकालिक होती हैं। पक्का करने से ठीक पहले हमेशा मूल्य या दर जाँचें: अगर कीमत बदल गई है, तो आपको नई राशि के साथ 409 price_changed मिलता है, और फ़ैसला आपका होता है।

5. प्रोडक्शन का अनुरोध करें

जब आपका इंटीग्रेशन सैंडबॉक्स में फ़्लो को शुरू से अंत तक पूरा कर ले, तो डेवलपर पोर्टल खोलें और प्रोडक्शन का अनुरोध करें। हम सैंडबॉक्स गतिविधि (खोजें, एक ऑर्डर, एक बुकिंग, एक रद्दीकरण) और आपके इंटीग्रेशन विवरण की समीक्षा करते हैं, फिर आपका खाता बदल देते हैं: प्रोडक्शन कुंजी जोड़ी उसी एक बार इस्तेमाल होने वाले लिंक से ईमेल की जाती है। बेस URL वही रहता है — dt_live_ कुंजी से हस्ताक्षरित अनुरोध लाइव आपूर्तिकर्ताओं तक पहुँचते हैं और उनका निपटान आपकी जमा राशि से होता है; आपकी सैंडबॉक्स कुंजी परीक्षण के लिए काम करती रहती है।