لائیو ڈیمو

ہوٹل سپلائر انٹیگریشن

Hotelbeds API انٹیگریشن: مواد، میپنگ اور لائیو بکنگ

Hotelbeds API انٹیگریشن ایک نہیں بلکہ دو کام ہیں۔ پہلے آپ ہوٹلوں کا مواد ڈاؤن لوڈ کر کے محفوظ کرتے ہیں، پھر لائیو ریٹس پر بکنگ کرتے ہیں۔ PHPTRAVELS یہ دونوں کام اپنے ہوٹل ماڈیول میں کرتا ہے، آپ کے اپنے Hotelbeds معاہدے اور کیز کے ساتھ۔

  • Content API سنک
  • Booking API فلو
  • BOOKABLE اور RECHECK ریٹس
  • ہوٹل میپنگ

Hotelbeds کی APIs آپس میں کیسے جڑتی ہیں

Hotelbeds API انٹیگریشن: ایک طرف مواد، دوسری طرف بکنگ

Hotelbeds اپنی ہوٹل APIs کو دو حصوں میں بانٹتا ہے۔ 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 ہوٹلوں کے کئی ذرائع میں سے ایک ہے جنہیں آپ ساتھ ساتھ چلا سکتے ہیں۔ ٹریول APIs کے جائزے میں دیکھیں کہ یہ 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 سے طے ہوتا ہے۔ قیمتوں کا صفحہ دیکھیں یا سیلز سے کوٹیشن مانگیں۔

مزید دیکھیں

پلیٹ فارم کے بارے میں مزید