लाइव डेमो

आवास API

होटल, अपार्टमेंट और वेकेशन रेंटल के लिए स्टेज़ API

स्टेज़ API हर तरह का आवास आपकी बुकिंग साइट तक पहुँचाती है: होटल रूम, सर्विस्ड अपार्टमेंट, हॉलिडे होम, हॉस्टल और गेस्टहाउस। यह पेज बताता है कि एक ठहराव के पीछे कौन सा डेटा होता है, कौन से नियम रेंटल को होटल से अलग बनाते हैं, और PHPTRAVELS आपकी अपनी प्रॉपर्टी और सप्लायर स्टॉक को एक ही सर्च में कैसे बेचता है।

  • प्रॉपर्टी, यूनिट, रेट, कैलेंडर
  • न्यूनतम ठहराव और शुल्क
  • रद्दीकरण अवधि
  • अपना स्टॉक और API सप्लाई

डेटा मॉडल

हर ठहराव के भीतर चार परतें

चाहे 300 कमरों का होटल हो या समुद्र किनारे का एक घर, आवास API उसे इन्हीं चार नेस्टेड परतों में बताती है। हर परत उस अलग सवाल का जवाब देती है जो मेहमान बुकिंग से पहले पूछता है।

01प्रॉपर्टी

जगह स्वयं: नाम, प्रकार, पता और मैप पर स्थान, फ़ोटो, सुविधाएँ, स्टार या गुणवत्ता रेटिंग, घर के नियम और चेक-इन का समय।

property_id · type · address · geo · photos · amenities · check_in_from

02कमरा या यूनिट

जो असल में बुक होता है: कमरे का प्रकार, पूरा अपार्टमेंट या साझा डॉर्म में एक बिस्तर, उसके आकार, बिस्तरों और अधिकतम क्षमता के साथ।

unit_id · beds · size_m2 · max_adults · max_children

03रेट प्लान

वह यूनिट कैसे बिकती है: भोजन व्यवस्था, रद्दीकरण नीति, भुगतान की शर्तें और कौन बुक कर सकता है, जैसे आम जनता या केवल एजेंट।

rate_plan_id · board · cancel_policy · payment · channel

04उपलब्धता

हर रात की एक पंक्ति: कीमत, बची हुई यूनिट, न्यूनतम ठहराव और उस दिन आगमन या प्रस्थान की अनुमति है या नहीं।

date · price · units_left · min_stay · closed_to_arrival

एक आवास लिस्टिंग की अलग-अलग एक के ऊपर एक रखी परतों के रूप में बनी इमारत, कमरा, कीमत का टैग और कैलेंडर

PHPTRAVELS अपने आवास मॉड्यूल को Stays कहता है, क्योंकि यही मॉडल होटलों से कहीं ज़्यादा को कवर करता है। एक प्रॉपर्टी में यूनिट होती हैं, एक यूनिट एक या अधिक रेट प्लान से बिकती है, और हर रेट प्लान का कीमत और उपलब्धता का रात-दर-रात कैलेंडर होता है। ये चारों परतें सही हों तो हॉस्टल का बिस्तर, होटल सुइट और तीन बेडरूम का विला, सब एक ही सर्च और चेकआउट में समा जाते हैं।

सप्लायर परतों के नाम अलग रखते हैं और कुछ दो को मिला देते हैं, पर ढांचा हमेशा मौजूद रहता है। होटल हर स्रोत को इसी से मैप करता है, ताकि मेहमान को एक सुसंगत पेज दिखे।

रात-दर-रात

उपलब्धता कैलेंडर में ही तय होता है कि ठहराव बिकेगा या छूटेगा

हर स्टेज़ API एक कैलेंडर पर खत्म होती है। सर्च कोई प्रॉपर्टी तभी लौटाती है जब माँगे गए ठहराव की हर रात खाली हो, उसकी कीमत हो और ठहराव के नियम अनुमति दें।

दो बेडरूम अपार्टमेंट · स्टैंडर्ड रेटनवंबर 2026 · प्रति रात कीमत
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • खाली, प्रति रात कीमत के साथ
  • पहले से बुक
  • मालिक द्वारा बंद
  • इस आगमन से न्यूनतम ठहराव
  • आगमन के लिए बंद

उदाहरण डेटा, सरल किया गया

  • कीमतें प्रति रात होती हैंठहराव का कुल खर्च हर रात का योग है, इसलिए वीकेंड रेट पर शुक्रवार और शनिवार दो सामान्य दिनों से महँगे पड़ते हैं। दैनिक और मौसमी कीमतें कैलेंडर में रहती हैं, प्रॉपर्टी पर नहीं।
  • न्यूनतम ठहराव के नियमशुक्रवार के आगमन पर तीन रातों की न्यूनतम शर्त यूनिट को दो रातों की सर्च से छिपा देती है। रेंटल ये नियम होटलों से कहीं ज़्यादा इस्तेमाल करते हैं, अक्सर वीकेंड और पीक सीज़न में और सख़्त।
  • आगमन या प्रस्थान के लिए बंदएक रात लंबे ठहराव के हिस्से के रूप में बुक हो सकती है, पर पहली या आख़िरी रात के रूप में नहीं। हॉलिडे होम के चेंजओवर डे इसी तरह काम करते हैं।
  • बंद रातें और स्टॉप-सेलमालिक अपने उपयोग या रखरखाव के लिए तारीख़ें ब्लॉक करते हैं, और स्टॉप-सेल यूनिट को तुरंत बिक्री से हटा देता है। माँगी गई तारीख़ों के भीतर कोई भी बंद रात यूनिट को नतीजों से हटा देती है।

हर आवास होटल नहीं होता

होटल बनाम अपार्टमेंट बनाम वेकेशन रेंटल

डेटा मॉडल साझा है, पर हर तरह का आवास उसे अलग ढंग से भरता है। होटल के कमरों से ज़्यादा बेचने पर आपके बुकिंग फ़्लो को यही अंतर संभालने पड़ते हैं।

होटल

हॉस्टल और गेस्टहाउस सहित

क्या बुक होता है
कमरे का एक प्रकार जिसके कई एक जैसे कमरे हों, या साझा डॉर्म में एक बिस्तर।
कीमत तय करना
प्रति कमरा और भोजन व्यवस्था के हिसाब से रात का रेट; अतिरिक्त वयस्क या बच्चे इसे बदल सकते हैं।
ठहराव के नियम
न्यूनतम ठहराव सिर्फ़ पीक तारीख़ों पर; ज़्यादातर रातें अकेले बुक हो सकती हैं।
शुल्क और डिपॉज़िट
सिटी या टूरिस्ट टैक्स, कभी-कभी प्रॉपर्टी पर चुकाया जाने वाला रिसॉर्ट शुल्क।
आगमन
24 घंटे या स्टाफ़ वाला फ़्रंट डेस्क; वाउचर पर चेक-इन का समय काफ़ी है।
सामान्य स्रोत
बेडबैंक और होलसेलर, सीधे अनुबंध, चैनल मैनेजर।

सर्विस्ड अपार्टमेंट

अपार्टहोटल और शहरी अपार्टमेंट

क्या बुक होता है
यूनिट का एक प्रकार, अक्सर रसोई और अलग बेडरूम के साथ।
कीमत तय करना
प्रति यूनिट रात का रेट, लंबे ठहराव के लिए साप्ताहिक या मासिक कीमतों के साथ।
ठहराव के नियम
न्यूनतम ठहराव आम है, और लंबे ठहराव माँग का बड़ा हिस्सा हैं।
शुल्क और डिपॉज़िट
हर ठहराव पर सफ़ाई शुल्क और वापसी योग्य डिपॉज़िट आम हैं।
आगमन
रिसेप्शन का समय अलग-अलग होता है; देर से पहुँचने पर की बॉक्स या कोड चाहिए।
सामान्य स्रोत
चैनल मैनेजर, सीधे अनुबंध और कुछ होलसेलर।

वेकेशन रेंटल

हॉलिडे होम, विला और केबिन

क्या बुक होता है
एक विशिष्ट घर। आमतौर पर उसका एक ही होता है।
कीमत तय करना
पूरे घर का रात का रेट, साथ में बुनियादी संख्या से ऊपर हर अतिरिक्त मेहमान पर अलग शुल्क।
ठहराव के नियम
न्यूनतम ठहराव, तय चेंजओवर डे और आगमन के लिए बंद तारीख़ें सामान्य बात हैं।
शुल्क और डिपॉज़िट
सफ़ाई शुल्क, नुक़सान का वापसी योग्य डिपॉज़िट और स्थानीय कर, हर एक भुगतान से पहले दिखाया जाता है।
आगमन
चेक-इन निर्देश, पता और संपर्क आगमन से पहले भेजे जाते हैं, सार्वजनिक पेज पर कभी नहीं।
सामान्य स्रोत
मालिक और प्रॉपर्टी मैनेजर, सीधे या चैनल मैनेजर के ज़रिए।

अपने अनुबंधों के बजाय कई होस्ट के घर बेच रहे हैं? वह मार्केटप्लेस है, जो BnB पोर्टल पेज पर बताया गया है।

रद्दीकरण नीति की अवधियाँ

एक बुकिंग, रद्दीकरण की तीन अवधियाँ

रद्दीकरण नीति आगमन की तारीख़ से पीछे की ओर गिनी जाने वाली टाइमलाइन है। हर अवधि बताती है कि उसके भीतर रद्द करने पर मेहमान को क्या वापस मिलेगा।

बुकिंगचेक-इन
  1. 01 · आगमन से 14 दिन पहले तकमुफ़्त रद्दीकरणमेहमान रद्द करता है और पूरा पैसा वापस मिलता है। यात्री सबसे पहले यही अंतिम तारीख़ देखते हैं, इसलिए इसे नियम नहीं, तारीख़ के रूप में दिखाएँ।
  2. 02 · 14 से 3 दिन पहलेआंशिक जुर्मानाजुर्माना लगता है, अक्सर पहली रात या ठहराव का एक प्रतिशत। इस अवधि में रेंटल डिपॉज़िट रख सकते हैं।
  3. 03 · आख़िरी 3 दिन और नो-शोवापसी योग्य नहींपूरी रकम रख ली जाती है। वापसी-रहित बिकने वाले रेट प्लान बुकिंग के क्षण से ही इस अवधि में होते हैं।
उदाहरण अवधियाँ; हर रेट प्लान की अपनी होती हैं।
  • प्रति रेट प्लान, प्रति प्रॉपर्टी नहींएक ही अपार्टमेंट का लचीला रेट और सस्ता वापसी-रहित रेट हो सकता है, इसलिए नीति रेट प्लान परत की होती है।
  • प्रॉपर्टी के टाइम ज़ोन में तारीख़ें"14 दिन पहले" प्रॉपर्टी के स्थान पर आगमन की तारीख़ से गिना जाता है। पेज और वाउचर पर इसे साफ़ तारीख़ और समय में बदलकर दिखाएँ।
  • सप्लायर की नीति ही मान्य हैAPI स्टॉक के साथ आप सप्लायर से नरम शर्तें नहीं दे सकते। अपने अनुबंधों के साथ अवधियाँ आप ख़ुद तय करते हैं।

अपना स्टॉक और API स्टॉक

आपकी अनुबंधित प्रॉपर्टी और सप्लायर API एक ही सर्च में

ज़्यादातर आवास विक्रेता दोनों करते हैं: जिन जगहों से ख़ुद अनुबंध करते हैं उन्हें लोड करते हैं और बाकी के लिए सप्लायर API जोड़ते हैं। यात्री को कभी पता नहीं चलना चाहिए कि ठहराव कहाँ से आया।

आपकी अपनी प्रॉपर्टी

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

सप्लायर API स्टॉक

  • ऐसे गंतव्यों में बड़े कैटलॉग जहाँ आप कभी ख़ुद अनुबंध नहीं कर सकते
  • सर्च के समय लाइव कीमतें और उपलब्धता
  • हर रेट पर सप्लायर की भोजन व्यवस्था, नीतियाँ और शुल्क
  • आपके अपने सप्लायर अनुबंध और क्रेडेंशियल से चालू
  • बुकिंग और रद्दीकरण सीधे सप्लायर को भेजे जाते हैं

मेहमान को क्या मिलता है

  • नतीजों की एक सूची और हर जगह का एक प्रॉपर्टी पेज
  • कई स्रोतों का एक ही कमरा आपकी कीमत पर एक बार दिखाया जाता है
  • सप्लायर, गंतव्य या चैनल के हिसाब से आपका मार्कअप, और B2B एजेंट रेट
  • एक ही वाउचर फ़ॉर्मेट, चाहे पुष्टि किसी भी स्रोत ने की हो

चैनल मैनेजर जोड़ने के बारे में चैनल मैनेजर इंटीग्रेशन पर है। अनुबंध के तहत रखे कमरों के लिए बुकिंग इन्वेंटरी सिस्टम देखें।

PHPTRAVELS में तैयार

पहले से जुड़े स्टेज़ सप्लायर

ये आवास सप्लायर आज Stays मॉड्यूल से जुड़े हैं। आप सप्लायर के साथ अनुबंध करते हैं, एडमिन में अपने क्रेडेंशियल डालते हैं, उनके सैंडबॉक्स में टेस्ट करते हैं और लाइव हो जाते हैं। सूची हमारी इंटीग्रेशन डायरेक्टरी से लाइव आती है।

ऐसा सप्लायर चाहिए जो सूची में नहीं है, जैसे कोई क्षेत्रीय रेंटल नेटवर्क? दस्तावेज़ वाली कोई भी आवास API जोड़ी जा सकती है, देखें कस्टम API इंटीग्रेशन। होटल सप्लायर के प्रकार और कंटेंट मैपिंग के लिए होटल API पेज पढ़ें, और दो सबसे बड़े बेडबैंक गाइड: RateHawk API इंटीग्रेशन और Hotelbeds API इंटीग्रेशन।

ठहराव वैसे बुक करें जैसे आपके मेहमान करेंगे

लाइव डेमो में सर्च करें, रेट की तुलना करें और बुक करें, फिर हमें बताएँ कि आप कौन सी प्रॉपर्टी और सप्लायर बेचना चाहते हैं।

लाइव डेमो आज़माएँअपने सप्लायर के बारे में पूछें

अपना ऐप या पार्टनर फ़ीड बना रहे हैं? PHPTRAVELS REST API जुड़े हुए सभी Stays स्रोत एक ही फ़ॉर्मेट में देती है, बुकिंग इवेंट के लिए वेबहुक के साथ। यह Enterprise प्लान के साथ आती है, देखें कीमतें और डेवलपर दस्तावेज़। बड़ी तस्वीर ट्रैवल API पर है।

FAQ

स्टेज़ API: डेवलपर और एजेंसियों के सवाल

सेल्स से बात करें

स्टेज़ API वेब सर्विस का एक समूह है जिससे बुकिंग साइट आवास सर्च करती है, तय तारीख़ों और मेहमानों के लिए कीमत और उपलब्धता पढ़ती है, और बुकिंग बनाती, देखती और रद्द करती है। यह होटलों और आवास के हर दूसरे प्रकार को कवर करती है: अपार्टमेंट, वेकेशन रेंटल, हॉस्टल और गेस्टहाउस।

मूल कॉल एक जैसे हैं। स्टेज़ API को वह भी संभालना होता है जो गैर-होटल आवास को चाहिए: पूरी यूनिट की बुकिंग, न्यूनतम ठहराव और चेंजओवर डे, अतिरिक्त मेहमान का शुल्क, सफ़ाई शुल्क, वापसी योग्य डिपॉज़िट और आगमन से पहले भेजे जाने वाले चेक-इन निर्देश।

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

कैलेंडर की हर रात पर न्यूनतम ठहराव की अवधि हो सकती है, जो आमतौर पर आगमन की तारीख़ से जुड़ी होती है। अगर मेहमान न्यूनतम से कम रातें सर्च करे तो यूनिट वापस नहीं आती। आगमन के लिए बंद और प्रस्थान के लिए बंद फ़्लैग चेंजओवर डे के लिए इसी तरह काम करते हैं।

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

रेट प्लान से। सप्लायर स्टॉक में सप्लायर की नीति होती है, और आपकी अपनी प्रॉपर्टी वे अवधियाँ इस्तेमाल करती हैं जो आप तय करते हैं। अंतिम तारीख़ भुगतान से पहले मेहमान को दिखाई जाती है और वाउचर पर छपती है।

नहीं। आप हर आवास सप्लायर के साथ ख़ुद अनुबंध करते हैं और एडमिन में अपने क्रेडेंशियल डालते हैं। PHPTRAVELS बुकिंग प्लेटफ़ॉर्म, Stays मॉड्यूल और तैयार कनेक्टर देता है।

जी हाँ। Enterprise प्लान पर PHPTRAVELS REST API सभी जुड़े स्रोतों पर सर्च और बुकिंग एक ही फ़ॉर्मेट में देती है, बुकिंग इवेंट के लिए वेबहुक और विस्तार के लिए पूरे सोर्स कोड के साथ।

एक PHPTRAVELS लाइसेंस, आपका अपना डोमेन और स्टॉक का कम से कम एक स्रोत: ख़ुद अनुबंध की हुई प्रॉपर्टी, चैनल मैनेजर, या आवास होलसेलर के साथ सप्लायर अनुबंध। लाइव डेमो पहले पूरा फ़्लो दिखाता है।

और जानें

प्लेटफ़ॉर्म के बारे में और