Online Booking API
يربط محرك الحجز في موقع الفندق بـ 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
التوثيق#
البدء
- نظرة عامةوظيفة Online Booking API، والعنوان الأساسي، وملخص المسار، والقواعد العامة.
- البدء السريعاحصل على رمز مميز ببيانات اعتماد الشريك وأرسل أول استعلام عن الغرف والأسعار.
- المصادقةتسجيل الدخول بـ apiKey / apiSecret، ورمز Bearer، وسياق الفندق، ومدة صلاحية الرمز.
- الطلبات والاستجاباتمتون النماذج وJSON، وغلاف success، وتقسيم الصفحات، وتنسيقات التواريخ والمبالغ، ورموز حالة HTTP.
- رموز الأخطاءقيم message وerrorCode، وأخطاء المصادقة، وإرشادات إعادة المحاولة.