نظرة عامة

تربط Online Booking API محرك الحجز في الموقع الإلكتروني الخاص بالفندق ببرنامج HMS لإدارة الفنادق. عبر هذه الواجهة تمر قوائم الغرف والأسعار، والتوافر في التقويم، والتحقق من قسائم الخصم، وخطوة الدفع، وإرسال الحجز إلى HMS. صُمّمت للوكالات التي تطوّر محركات الحجز ولشركاء HMS.

العنوان الأساسي#

تقع جميع نقاط النهاية تحت العنوان الأساسي أدناه، على المسار /external/…. لا يُقبل إلا HTTPS.

العنوان الأساسي لـ API

https://test.hms.gen.tr

المسار في لمحة#

1تسجيل الدخولPOST /external/public/login

2الغرف والأسعارPOST /external/online/roomType

3الدفعPOST …/payment/type/{type}

4الحجزPOST …/channel/booking

الرمز المميز الناتج عن تسجيل الدخول صالح لمدة 7 أيام ومرتبط بفندق واحد. تعيد قائمة الغرف الغرفَ القابلة للبيع وأسعارها للتواريخ وعدد النزلاء الذي بحث عنه النزيل؛ وبعد أن يختار النزيل ويُحسم نوع الدفع، يُسجَّل الحجز في HMS بصيغة BookingPushRQ. يشرح دليل مسار الحجز كل خطوة بالتفصيل.

الموارد#

المورد	نقاط النهاية
المصادقة	POST `/external/public/login`
الغرف والأسعار	POST `/external/online/roomType` GET `/external/room/type/hotel/availability`
الحجز	POST `/external/online/channel/booking`
الدفع	GET `/external/online/payment/type` GET `/external/payment/company` POST `/external/online/payment/type/{paymentType}`
قسيمة الخصم	POST `/external/online/coupon/search`
الباقات والإضافات	GET `/external/stock/packages`
معلومات الفندق	GET `/external/hotel/{hotelID}/contact/info` GET `/external/online/social/media` GET `/external/online/footer` GET `/external/online/mail/host`
القوائم المرجعية	POST `/external/counties` GET `/external/currencies` GET `/external/languages`

قواعد عامة#

يحمل كل طلب، باستثناء تسجيل الدخول، الترويسة Authorization: Bearer <token>.
تستقبل معظم نقاط النهاية من نوع POST حقول نموذج (application/x-www-form-urlencoded أو multipart/form-data)، أما إرسال الحجز وبدء الدفع فيتوقعان متنًا بتنسيق JSON. توضّح صفحة المرجع الخاصة بكل نقطة نهاية التنسيق المطلوب.
الاستجابات بتنسيق JSON وتتضمن مؤشر success. تعود أخطاء قواعد العمل أيضًا بحالة HTTP 200؛ لذا احكم على النتيجة من خلال success لا من رمز الحالة.
التواريخ بصيغة YYYY-MM-DD، والمبالغ سلاسل نصية بمنزلتين عشريتين ("965.00")، والعملة مأخوذة من إعدادات قناة الحجز عبر الإنترنت لدى الفندق.
يجب أن يطابق المعامل hotelID الفندقَ المرتبط به الرمز المميز.

الإصدار#

يغطي هذا التوثيق HMS API V2. قد تُضاف حقول ونقاط نهاية جديدة دون إشعار مسبق؛ لذا صمّم عميلك بحيث يتجاهل الحقول غير المعروفة. تُدرَج التغييرات في سجل التغييرات.

الخطوات التالية#

البدء السريعاحصل على رمز مميز وأرسل أول استعلام عن الغرف. المصادقةمفاتيح الشركاء ومدة صلاحية الرمز المميز. مسار الحجزمن البحث حتى الإرسال، خطوة بخطوة. مرجع APIكل نقطة نهاية ومعامل ومثال.

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