عرض تجريبي مباشر

تكامل مورّد الفنادق

تكامل Hotelbeds API: المحتوى والربط والحجز المباشر

تكامل Hotelbeds API مهمتان لا مهمة واحدة. تنزّل محتوى الفنادق وتخزّنه أولاً، ثم تحجز وفق الأسعار المباشرة. ينفّذ PHPTRAVELS المهمتين داخل وحدة الفنادق، بعقدك ومفاتيحك الخاصة مع Hotelbeds.

  • مزامنة Content API
  • مسار Booking API
  • أسعار BOOKABLE وRECHECK
  • ربط الفنادق

كيف تتكامل واجهات Hotelbeds

تكامل Hotelbeds API: المحتوى في جهة والحجز في جهة أخرى

تقسم Hotelbeds واجهات الفنادق إلى قسمين. يعيد 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 /checkratesالسعر والشروط المحدّثة لسعر موسوم بـ RECHECK، مع خيارات الترقية.
  • الحجز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 تمر بالتحقق من السعر قبل الدفع
  • الالتزام بـ sellingRate عندما تكون قيمة hotelMandatory هي true
  • ملاحظات السعر ورسوم الإلغاء معروضة قبل أن يدفع النزيل
  • القسيمة تعرض مرجع Hotelbeds وملاحظات السعر
  • الإلغاء يُحاكى أولاً ثم يُؤكَّد، مع تسجيل الرسوم

تحدد Hotelbeds خطوات الاعتماد والوصول إلى البيئة الحية وفق عقدك وسوقك.

التكلفة

ترخيص واحد للمحرك، وعقدك الخاص مع Hotelbeds

PHPTRAVELS ترخيص لمرة واحدة مع الشيفرة المصدرية. أما Hotelbeds فاتفاقية منفصلة بينك وبين Hotelbeds، لذا تبقى الأسعار الصافية والمفاتيح ملكك.

Startup
ترخيص لمرة واحدة
ترخيص لمرة واحدة
Agency
ترخيص لمرة واحدة
ترخيص لمرة واحدة
Enterprise
ترخيص لمرة واحدة
ترخيص لمرة واحدة

Hotelbeds واحد من عدة مصادر فنادق يمكنك تشغيلها جنباً إلى جنب. اطّلع على موقعه إلى جانب RateHawk في نظرة عامة على واجهات API السفر، أو قارن المورّدين في قائمة مورّدي 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. اطّلع على صفحة الأسعار أو اطلب عرض سعر من فريق المبيعات.

واصل الاستكشاف

المزيد عن المنصة