लाइव डेमो

होटल सप्लायर इंटीग्रेशन

Hotelbeds API इंटीग्रेशन: कंटेंट, मैपिंग और लाइव बुकिंग

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

  • Content API सिंक
  • Booking API फ़्लो
  • BOOKABLE और RECHECK रेट
  • होटल मैपिंग

Hotelbeds के API आपस में कैसे जुड़ते हैं

Hotelbeds API इंटीग्रेशन: एक तरफ़ कंटेंट, दूसरी तरफ़ बुकिंग

Hotelbeds अपने होटल API को दो हिस्सों में बाँटता है। Content API स्थिर डेटा देता है: विवरण, तस्वीरें, सुविधाएँ, मील प्लान और कमरे। Booking API लाइव उपलब्धता और कीमतें देता है और बुकिंग लेता है। बीच में कोई चरण चुनें और देखें कि वह कौन-सी कॉल इस्तेमाल करता है।

Content API

स्थिर, आपकी तरफ़ सेव
  • होटल सूचीhotels · from=1&to=1000आपके पोर्टफ़ोलियो के सभी होटल, हर रिक्वेस्ट में अधिकतम 1,000 होटल के पेजों में।
  • सुविधाएँ, मील और कमरेfacilities · boards · roomsकोड टेबल जो Booking API के कोड को ऐसे शब्दों में बदलती हैं जिन्हें मेहमान समझ सकें।
  • तस्वीरेंphotos.hotelbeds.com/giata/तस्वीरों के आंशिक पाथ, जो आपकी ज़रूरत के साइज़ में Hotelbeds फ़ोटो होस्ट से जोड़े जाते हैं।
  • रोज़ के बदलावlastUpdateTimeपहले लोड के बाद, lastUpdateTime के साथ रोज़ एक रिक्वेस्ट सिर्फ़ बदलाव लौटाती है।

रिक्वेस्ट फ़्लो

Booking API

लाइव, हर मेहमान के लिए कॉल
  • उपलब्धताPOST /hotelsआपके होटल कोड, तारीखों और ऑक्यूपेंसी के लिए कमरे, मील, कीमतें और कैंसलेशन शुल्क।
  • रेट चेकPOST /checkratesRECHECK चिह्नित रेट की अपडेटेड कीमत और शर्तें, साथ में अपसेलिंग विकल्प।
  • बुकिंगPOST /bookingsचुने गए rateKey को बुक करने वाले और मेहमानों के नामों के साथ कन्फ़र्म करती है और रेफ़रेंस लौटाती है।
  • कैंसलेशनDELETE /bookings · simulateशुल्क दिखाने के लिए कैंसलेशन का सिमुलेशन करती है, या बुकिंग को सच में कैंसल करती है।
नमूना स्क्रीन। कॉल developer.hotelbeds.com के दस्तावेज़ों के अनुसार हैं; फ़्लो दिखाता है कि PHPTRAVELS उन्हें कैसे इस्तेमाल करता है।

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

अगर आप खुद सप्लायर, उसके प्रोडक्ट और अकाउंट खोलने का तरीका जानना चाहते हैं, तो Hotelbeds सप्लायर प्रोफ़ाइल पढ़ें। यह पेज तकनीकी इंटीग्रेशन के बारे में है।

रेट के प्रकार

रेट के चार फ़ील्ड जो आपका चेकआउट बदल देते हैं

हर Hotelbeds रेट में कुछ गुण होते हैं जो तय करते हैं कि आप उसे तुरंत बुक कर सकते हैं या नहीं, कौन-सी कीमत दिखा सकते हैं और पैसा कौन लेता है। आपके इंजन को हर नतीजे में ये पढ़ने चाहिए।

फ़ील्डपहली स्थितिदूसरी स्थितिPHPTRAVELS क्या करता है

बुक करने योग्य या रीचेक

rateType		BOOKABLE

रेट अप टू डेट है। आप इसे किसी और कॉल के बिना बुक कर सकते हैं।

RECHECK

अपडेटेड कीमत और शर्तों के लिए पहले रेट चेक कॉल करना होगा।

RECHECK रेट के लिए पेमेंट चरण से पहले रेट चेक चलाता है और मेहमान को हर बदलाव दिखाता है।

नेट या कमीशन वाला

net · sellingRate		net

नेट मॉडल: कीमतें नेट हैं, इसलिए आप अपना मार्जिन जोड़ते हैं।

sellingRate

कमीशन मॉडल: कमीशन पहले से sellingRate में शामिल है, और वही अंतिम कीमत है।

नेट रेट पर आपके मार्कअप नियम लागू करता है और कमीशन वाले रेट sellingRate पर बेचता है।

तय बिक्री कीमत

hotelMandatory		true

hotelMandatory का मान true है: आपको sellingRate पर ही बेचना होगा।

false · null

नेट रेट पर false या खाली: आप अपना मार्जिन तय कर सकते हैं।

जब होटल इसकी माँग करे, तो दिखाई गई कीमत को sellingRate पर लॉक करता है, मार्कअप नियम चाहे जो कहे।

मेहमान कब भुगतान करता है

paymentType		AT_WEB

भुगतान बुकिंग के समय आपकी साइट के ज़रिए लिया जाता है।

AT_HOTEL

मेहमान सीधे होटल को भुगतान करता है।

रेट पर अभी भुगतान या होटल पर भुगतान का लेबल लगाता है और चेकआउट को उसी के अनुसार चलाता है।

आपको कौन-सा प्राइसिंग मॉडल मिलेगा, यह आपके Hotelbeds कॉन्ट्रैक्ट पर निर्भर करता है। Hotelbeds के अनुसार, आपका सेल्स मैनेजर आपके बिज़नेस के लिए मॉडल सुझाता है।

होटल मैपिंग

Hotelbeds होटलों को उन होटलों से मिलाएँ जिन्हें आप पहले से बेचते हैं

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

PHPTRAVELS में मैपिंग कैसे काम करती है

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

मैप किए गए होटल होटल में एक पेज, एक गैलरी और एक रिव्यू स्कोर साझा करते हैं, जबकि हर सप्लायर अपने रेट और नियम रखता है। यही मैपिंग आपकी पब्लिक साइट और आपका B2B ट्रैवल पोर्टल इस्तेमाल करते हैं।

होटल मैपिंग
  • Harbour View Hotelलिस्बन48291397%मिलान हुआ
  • Old Town Suitesप्राग11735492%मिलान हुआ
  • Palm Court Resortदुबई66201874%समीक्षा
  • Casa Azul Boutiqueसेविल–0%कोई मिलान नहीं
  • Northern Lights Lodgeट्रोम्सो90522766%समीक्षा
  • Riverside Apartmentsबुडापेस्ट33076198%मिलान हुआ

काल्पनिक होटलों और कोड वाली नमूना स्क्रीन।

Hotelbeds XML या JSON

हर रिक्वेस्ट साइन होती है, और टेस्टिंग छोटे से शुरू होती है

टीमें अब भी Hotelbeds XML खोजती हैं, लेकिन मौजूदा दस्तावेज़ JSON रिक्वेस्ट दिखाते हैं। दोनों तरह से ऑपरेशन एक जैसे हैं, और हर रिक्वेस्ट में दो हेडर होते हैं।

availability-request.sh (नमूना)
 1# X-Signature = SHA256(api key + secret + unix time in seconds) 2TS=$(date +%s) 3SIG=$(printf "%s%s%s" "$API_KEY" "$SECRET" "$TS" | sha256sum | cut -d" " -f1) 4 5curl -X POST https://api.test.hotelbeds.com/hotel-api/1.0/hotels \ 6  -H "Api-key: $API_KEY" \ 7  -H "X-Signature: $SIG" \ 8  -H "Accept: application/json" \ 9  -H "Content-Type: application/json" \10  -d '{11    "stay": { "checkIn": "2026-11-14", "checkOut": "2026-11-17" },12    "occupancies": [{ "rooms": 1, "adults": 2, "children": 0 }],13    "hotels": { "hotel": [482913, 117354] }14  }'1516# hotel codes come from your stored Content API data, never a live content call
Api-keyX-Signatureapi.test.hotelbeds.com
दो हेडर
आपकी की के साथ Api-key, और X-Signature: आपकी की, सीक्रेट और सेकंड में मौजूदा समय का SHA256 हैश।
टेस्ट होस्ट
Hotelbeds के अनुसार टेस्ट सर्वर प्रोडक्शन जैसे ही हैं, लेकिन वहाँ बुकिंग असली नहीं होतीं और कार्ड से पैसा नहीं कटता।
रोज़ 50 रिक्वेस्ट
नई कीज़ रोज़ 50 रिक्वेस्ट के कोटे वाला इवैल्यूएशन एनवायरनमेंट खोलती हैं। सर्टिफ़िकेशन के साथ ज़्यादा कोटा मिलता है।
लाइव कंटेंट कॉल नहीं
Hotelbeds चेतावनी देता है कि Content API को रियल टाइम में कॉल करने से क्रेडेंशियल ब्लॉक हो सकते हैं। PHPTRAVELS ऐसा कभी नहीं करता।

कंटेंट सिंक प्लानर

आपकी होटल सूची को कितनी Content API कॉल चाहिए

Hotelbeds के अनुसार होटल सूची अधिकतम 1,000 होटल के पेजों में आती है, और पहले लोड के बाद lastUpdateTime के साथ रोज़ की रिक्वेस्ट सिर्फ़ बदलाव लौटाती है। सिंक की योजना बनाने के लिए अपने आँकड़े डालें।

पहले पूरे लोड के लिए रिक्वेस्ट
20
हर दैनिक अपडेट के लिए रिक्वेस्ट
3
इवैल्यूएशन कोटे पर एक बार लोड के दिन
1

सिर्फ़ अनुमान, होटल सूची के लिए। कोड टेबल और तस्वीरें कुछ और कॉल जोड़ती हैं। रोज़ 50 रिक्वेस्ट के इवैल्यूएशन कोटे पर पहले एक डेस्टिनेशन से टेस्ट करें।

गो-लाइव चेकलिस्ट

लाइव पर जाने से पहले क्या तैयार रखें

Hotelbeds अपने डैशबोर्ड के ज़रिए आपको इवैल्यूएशन से सर्टिफ़िकेशन और फिर लाइव कीज़ तक ले जाता है। ये वे बिंदु हैं जिन्हें Hotelbeds API इंटीग्रेशन को सबसे पहले पूरा करना चाहिए, और PHPTRAVELS उन्हें कैसे पूरा करता है।

  • इवैल्यूएशन कीज़ एडमिन में जोड़ी गईं, टेस्ट होस्ट चुना गया
  • Content API आपके डेटाबेस से सिंक, रोज़ का अपडेट शेड्यूल
  • होटल आपकी सूची से मैप, संदिग्ध मिलानों की समीक्षा पूरी
  • RECHECK रेट पेमेंट से पहले रेट चेक से गुज़रते हैं
  • hotelMandatory का मान true होने पर sellingRate का पालन
  • रेट कमेंट और कैंसलेशन शुल्क मेहमान के भुगतान से पहले दिखाए जाते हैं
  • वाउचर पर Hotelbeds रेफ़रेंस और रेट कमेंट दिखते हैं
  • कैंसलेशन पहले सिमुलेट, फिर कन्फ़र्म, और शुल्क रिकॉर्ड

सर्टिफ़िकेशन के चरण और लाइव एक्सेस Hotelbeds आपके कॉन्ट्रैक्ट और मार्केट के अनुसार तय करता है।

लागत

इंजन के लिए एक लाइसेंस, Hotelbeds के साथ आपका अपना कॉन्ट्रैक्ट

PHPTRAVELS सोर्स कोड के साथ एक बार का लाइसेंस है। Hotelbeds आपके और Hotelbeds के बीच एक अलग समझौता है, इसलिए नेट रेट और कीज़ आपकी ही रहती हैं।

Startup
एकमुश्त लाइसेंस
एक बार का लाइसेंस
Agency
एकमुश्त लाइसेंस
एक बार का लाइसेंस
Enterprise
एकमुश्त लाइसेंस
एक बार का लाइसेंस

Hotelbeds होटलों के कई स्रोतों में से एक है जिन्हें आप साथ-साथ चला सकते हैं। ट्रैवल API के ओवरव्यू में देखें कि यह RateHawk के साथ कैसे बैठता है, या XML सप्लायर सूची में सप्लायरों की तुलना करें।

कीमतें देखेंहोटल डेमो आज़माएँ

अक्सर पूछे जाने वाले सवाल

Hotelbeds API इंटीग्रेशन से जुड़े सवाल

Hotelbeds जोड़ने से पहले डेवलपर और ट्रैवल कंपनियाँ क्या पूछती हैं।

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

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

लोग अब भी इसे Hotelbeds XML कहते हैं, लेकिन Hotelbeds के मौजूदा दस्तावेज़ JSON रिक्वेस्ट और रिस्पॉन्स दिखाते हैं। दोनों तरह से ऑपरेशन एक जैसे हैं, और फ़ॉर्मेट PHPTRAVELS आपके लिए संभालता है।

BOOKABLE रेट पहले से अप टू डेट होता है और तुरंत बुक किया जा सकता है। RECHECK रेट के लिए पहले रेट चेक कॉल चाहिए, जो मौजूदा कीमत और शर्तें लौटाती है। PHPTRAVELS यह कॉल पेमेंट चरण से पहले करता है।

यह धीमा है, और Hotelbeds चेतावनी देता है कि Content API का रियल टाइम इस्तेमाल क्रेडेंशियल ब्लॉक होने का कारण बन सकता है। कंटेंट को पेजों में डाउनलोड करके सेव करना और lastUpdateTime के साथ रोज़ एक बार अपडेट करना चाहिए, और PHPTRAVELS ऐसे ही काम करता है।

हाँ। आप Hotelbeds के साथ रजिस्टर करते हैं, कॉन्ट्रैक्ट साइन करते हैं और अपनी API की और सीक्रेट पाते हैं। सर्टिफ़िकेशन पूरा होने तक नई कीज़ रोज़ 50 रिक्वेस्ट वाले इवैल्यूएशन एनवायरनमेंट में काम करती हैं।

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

PHPTRAVELS प्लान सोर्स कोड के साथ एक बार के लाइसेंस के रूप में से शुरू होते हैं। आपका Hotelbeds कॉन्ट्रैक्ट अलग है और सीधे Hotelbeds से तय होता है। प्राइसिंग पेज देखें या सेल्स से कोटेशन माँगें।

और जानें

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