بوابة المطوّرينبرنامج HMS لإدارة الفنادق

اربط برنامجك بوحدات HMS

توثيق API مستقل لكل وحدة من وحدات برنامج إدارة الفنادق: محرك الحجز، وشبكة Wi-Fi للنزلاء، ونقاط البيع للمطاعم، والسبا، والتلفاز، والمقسم الهاتفي، وخدمات الذكاء الاصطناعي. واجهتا Online Booking وHotspot متاحتان الآن، وستتبعهما البقية.

المصادقة
رمز Bearer أو ترويسة ApiKey
التنسيق
استجابات JSON بغلاف success
متاح
منتجان · 17 نقطة نهاية
قريبًا
5 منتجات
الطلب
# استعلام الغرف والأسعار
curl "https://test.hms.gen.tr/external/online/roomType" \
  -H "Authorization: Bearer $HMS_TOKEN" \
  -d "hotelID=1000" -d "startDate=2026-08-18" -d "endDate=2026-08-20" \
  -d "adultCount=2"
الاستجابة · 200 (مختصرة)
{
    "success": true,
    "items": [
        {
            "id": 2,
            "name": "غرفة قياسية",
            "roomCount": 5,
            "currency": "TRY",
            "accommodationTypes": [
                {
                    "id": 2,
                    "title": "مبيت وإفطار",
                    "prices": {
                        "2-1": {
                            "total": 2,
                            "price": "1930.00",
                            "nonRefundable": ""
                        },
                        "2-0": {
                            "total": 2,
                            "price": "1737.00",
                            "nonRefundable": "[NR]"
                        }
                    }
                }
            ]
        }
    ],
    "count": 1
}

المنتجات

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

متاح

Online Booking

API محرك الحجز

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

8 موارد · 16 نقطة نهايةالتوثيق
متاح

Hotspot

شبكة Wi-Fi للنزلاء وسجلات القانون 5651

يزوّد نظام hotspot بقائمة النزلاء المقيمين: الغرفة والهوية ووقتا الوصول والمغادرة. للتحقق من دخول النزلاء إلى شبكة Wi-Fi برقم الغرفة، ولحفظ سجلات الوصول وفق القانون التركي رقم 5651.

مورد واحد · نقطة نهاية واحدةالتوثيق
قريبًا

نقاط البيع للمطاعم

الفواتير والقيد على الغرفة

قيد فواتير المطعم والبار والمقهى على حساب الغرفة، ومزامنة قائمة الطعام والمخزون.

التوثيق قيد الإعداد
قريبًا

Spa

المواعيد والخدمات

مواعيد السبا والعافية، وكتالوج الخدمات، والتكامل مع القيد على حساب الغرفة.

التوثيق قيد الإعداد
قريبًا

الذكاء الاصطناعي

خدمات المساعد والتوصيات

الوصول إلى خدمات الذكاء الاصطناعي لمساعد النزلاء واقتراح الأسعار وإعداد التقارير.

التوثيق قيد الإعداد
قريبًا

TV

أنظمة التلفاز داخل الغرف

بيانات النزيل وحساب الغرفة والرسائل وطلبات الخدمة لواجهة التلفاز داخل الغرفة.

التوثيق قيد الإعداد
قريبًا

المقسم الهاتفي

مقسم PBX وسجلات المكالمات

التكامل مع المقسم الهاتفي: فتح الخطوط وإغلاقها عند تسجيل الوصول والمغادرة، وقيد رسوم المكالمات على حساب الغرفة.

التوثيق قيد الإعداد

مبادئ مشتركة بين جميع المنتجات

بعد تكامل وحدة واحدة، ستجد الوحدات الأخرى مألوفة.

مفتاح مرتبط بالفندق

في Online Booking يُستبدل زوج apiKey/apiSecret الصادر عن HMS برمز Bearer مرتبط بالفندق وصالح لمدة 7 أيام. أما التكاملات داخل الفندق مثل Hotspot فتستخدم مفتاحًا يُنشأ في لوحة تحكم الفندق نفسه، ويُرسَل في ترويسة ApiKey مع كل طلب.

المصادقة

غلاف success

الاستجابات بتنسيق JSON وتحمل مؤشر success. تعود أخطاء قواعد العمل بحالة HTTP 200 مع message أو errorCode؛ أما أخطاء المصادقة فحالتها 401.

الطلبات والاستجابات

أمثلة جاهزة للتشغيل

تُولَّد أمثلة cURL وNode.js وPHP لكل نقطة نهاية؛ انسخها وأضف مفتاحك وشغّلها.

مرجع API

أحدث التغييرات

سجل التغييرات الكامل

  • الموقع
    دعم 22 لغة
    جديدجديد
  • Hotspot
    نشر توثيق Hotspot API
    جديدجديد
  • Online Booking
    نشر توثيق Online Booking API
    جديدجديدجديد

هل تواجه مشكلة؟

يرد فريق المطوّرين لدينا خلال يوم عمل واحد.

أرفق متن الطلب (مع إخفاء المفاتيح السرية وبيانات البطاقات) والاستجابة والوقت. واستخدم العنوان نفسه لطلبات مفاتيح الشركاء والفنادق التجريبية والوصول المبكر.