Online Booking API

متاحHMS API V2API محرك الحجز

يربط محرك الحجز في موقع الفندق بـ HMS: قائمة الغرف والأسعار، والتوافر في التقويم، وقسائم الخصم، والدفع، وإرسال الحجوزات.

العنوان الأساسي
https://test.hms.gen.tr
المصادقة
apiKey / apiSecret ← رمز Bearer
التنسيق
استجابات JSON · متن الطلب بتنسيق النموذج أو JSON
النطاق
8 موارد · 16 نقطة نهاية

الموارد#

المصادقة

نقطة نهاية واحدة

يتم الوصول إلى Online Booking API ببيانات اعتماد الشريك التي تصدرها HMS. تستبدل نقطة نهاية تسجيل الدخول apiKey وapiSecret برمز مميز يُرسَل في ترويسة A…

  • POST/external/public/login

الغرف والأسعار

نقطتا نهاية

نقطتا نهاية تغذّيان نتائج البحث في محرك الحجز: قائمة الغرف، وتعيد أنواع الغرف القابلة للبيع وأنواع الإقامة والأسعار للتواريخ وعدد النزلاء المحددين، وا…

  • POST/external/online/roomType
  • GET/external/room/type/hotel/availability

الحجز

نقطة نهاية واحدة

تُرسَل الغرفة ونوع الإقامة والسعر الذي اختاره النزيل إلى HMS في بنية BookingPushRQ. وتعالج نقطة النهاية نفسها الإلغاء والتعديل بإرسال type بالقيمة Can…

  • POST/external/online/channel/booking

الدفع

3 نقاط نهاية

تعرض أنواع الدفع التي يقبلها الفندق للحجوزات عبر الإنترنت، وتبدأ خطوة الدفع للنوع المختار. يشرح دليل مسار الدفع ما يلزم لكل نوع.

  • GET/external/online/payment/type
  • GET/external/payment/company
  • POST/external/online/payment/type/{paymentType}

قسيمة الخصم

نقطة نهاية واحدة

تتحقق من قسائم الخصم الإلكترونية التي عرّفها الفندق في لوحة التحكم. طبّق الخصم من جهتك وأرسل المبالغ بعد الخصم عند إرسال الحجز.

  • POST/external/online/coupon/search

الباقات والإضافات

نقطة نهاية واحدة

الإضافات التي يمكن بيعها مع الحجز: باقات الغرف (المرتبطة بنوع غرفة) والباقات العامة (التوصيل، والعشاء، والسبا). تُرسَل الباقات المبيعة عند إرسال الحجز…

  • GET/external/stock/packages

معلومات الفندق

4 نقاط نهاية

بيانات تملأ الإطار العام لصفحات محرك الحجز: بيانات الاتصال والموقع، وروابط وسائل التواصل الاجتماعي، ونصوص التذييل (النصوص القانونية، ونبذة عن الفندق، …

  • GET/external/hotel/{hotelID}/contact/info
  • GET/external/online/social/media
  • GET/external/online/footer
  • +1 أخرى

القوائم المرجعية

3 نقاط نهاية

قوائم ثابتة لخيارات النماذج: الدول والعملات واللغات. نادرًا ما تتغير، ويمكن تخزينها مؤقتًا لمدة يوم.

  • POST/external/counties
  • GET/external/currencies
  • GET/external/languages

التوثيق#

البدء

الأدلة

آخر تحديث: 21 سبتمبر 2026هل وجدت خطأً؟ أخبرنا