एनवायरनमेंट, सीमाएँ और संस्करण

सैंडबॉक्स और प्रोडक्शन, एक बेस URL

बेस URL: https://api.dubaitrip.com/v1। सैंडबॉक्स और प्रोडक्शन इसे साझा करते हैं; जिस कुंजी से आप हस्ताक्षर करते हैं, वही एनवायरनमेंट चुनती है। dt_sbx_ कुंजी हमारे आपूर्तिकर्ताओं के टेस्ट एनवायरनमेंट पर चलती है — खोज, मूल्य निर्धारण, दर जाँच, ऑर्डर, बुकिंग, टिकटिंग और रद्दीकरण सब टेस्ट इन्वेंटरी पर शुरू से अंत तक काम करते हैं, बिना किसी असली टिकट या वाउचर के और बिना कोई शुल्क लिए। प्रोडक्शन समीक्षा के बाद जारी की गई dt_live_ कुंजी लाइव इन्वेंटरी तक पहुँचती है और उसका निपटान आपकी जमा राशि से होता है।

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

रेट सीमाएँ और कोटा

हर कुंजी को एक टोकन बकेट (प्रति सेकंड लगातार अनुरोध और एक बर्स्ट) और एक दैनिक कोटा से नियंत्रित किया जाता है। सैंडबॉक्स डिफ़ॉल्ट: 2 अनुरोध/सेकंड, बर्स्ट 5, 2,000 अनुरोध/दिन। प्रोडक्शन सीमाएँ हर खाते के लिए तय की जाती हैं। बकेट पार होने पर Retry-After हेडर के साथ 429 api_rate_limited मिलता है; कोटा खत्म होने पर UTC आधी रात तक 429 api_quota_exceeded मिलता है।

भारी खोजें डिज़ाइन से ही एसिंक्रोनस हैं: तुरंत searchId पाने और खोज एंडपॉइंट को पोल करने के लिए wait=false भेजें, या एक ही कॉल में पूरा परिणाम पाने के लिए wait=true। पोलिंग भी किसी अन्य अनुरोध की तरह आपकी सीमाओं में गिनी जाती है।

लुक-टू-बुक सुरक्षा

खोजें आपकी बुकिंग के अनुपात में भी सीमित की जाती हैं। पिछली अवधि (डिफ़ॉल्ट रूप से 7 दिन) का हर दिन खोजों का एक मुफ़्त कोटा देता है, और उस अवधि में की गई हर बुकिंग उसके ऊपर cap जितनी खोजें और जोड़ती है — cap आपके खाते के लिए तय की गई और डेवलपर पोर्टल पर दिखाई गई प्रति बुकिंग खोजों की संख्या है। पोल, मूल्य निर्धारण, किराया नियम और सामग्री पढ़ना कभी नहीं गिना जाता; केवल उड़ान और होटल खोज कॉल गिनी जाती हैं।

कोटा खत्म होने पर खोजों का जवाब 429 look_to_book_exceeded होता है, जिसके Retry-After हेडर में अगली UTC आधी रात का समय होता है, जब अवधि का सबसे पुराना दिन हट जाता है। एक बुकिंग तुरंत कोटा फिर से खोल देती है। डेवलपर पोर्टल का लुक-टू-बुक कार्ड लाइव काउंटर, सीमा और बची हुई खोजें दिखाता है; अगर आपका इंटीग्रेशन वैध रूप से बुकिंग की तुलना में कहीं ज़्यादा खोज करता है, तो अस्वीकृति के बावजूद दोबारा प्रयास करने के बजाय हमसे सीमा बढ़ाने को कहें।

आइडेम्पोटेंसी

जो एंडपॉइंट पैसा या इन्वेंटरी पक्की करते हैं — ऑर्डर या बुकिंग बनाना, जारी करना, रद्द करना — उनके लिए Idempotency-Key हेडर आवश्यक है (128 वर्णों तक की कोई भी अद्वितीय स्ट्रिंग, UUID आदर्श है)। उसी कुंजी के साथ दोबारा प्रयास करने पर डुप्लिकेट बनाने के बजाय मूल प्रतिक्रिया लौटती है; दोबारा इस्तेमाल की गई कुंजी के साथ अलग बॉडी भेजने पर 409 मिलता है।

संस्करण

संस्करण पाथ में होता है (/v1)। जोड़ने वाले बदलाव — नए वैकल्पिक फ़ील्ड, नए enum मान, नए एंडपॉइंट — संस्करण बढ़ाए बिना जारी किए जाते हैं, इसलिए सावधानी से पार्स करें और अज्ञात फ़ील्ड को अनदेखा करें। असंगत बदलावों को माइग्रेशन अवधि के साथ एक नया मुख्य संस्करण मिलता है; चेंजलॉग गाइड हर बदलाव सूचीबद्ध करती है।