اربط برنامجك بوحدات 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"# قائمة النزلاء المقيمين
curl -X POST "https://test.hms.gen.tr/public/json/customer/inhotel" \
-H "ApiKey: $HMS_API_KEY" \
-H "HotelCode: 1000"{
"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
}{
"success": 1,
"otelde": [
{
"unique": 58211,
"firstName": "AYŞE",
"lastName": "DEMİR",
"identityNumber": "11111111110",
"birthDate": "14.03.1985",
"roomName": "104",
"checkin": 1788863400,
"checkout": 1788998400,
"rezervasyon_id": 282799
}
]
}المنتجات
لكل منتج توثيقه ومرجع API وأمثلة الشيفرة الخاصة به. يُعلَن عن المنتجات القادمة في سجل التغييرات عند إطلاقها.
Online Booking
API محرك الحجز
يربط محرك الحجز في موقع الفندق بـ HMS: قائمة الغرف والأسعار، والتوافر في التقويم، وقسائم الخصم، والدفع، وإرسال الحجوزات.
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 APIجديدجديد
-
نشر توثيق Online Booking APIجديدجديدجديد
هل تواجه مشكلة؟
يرد فريق المطوّرين لدينا خلال يوم عمل واحد.
أرفق متن الطلب (مع إخفاء المفاتيح السرية وبيانات البطاقات) والاستجابة والوقت. واستخدم العنوان نفسه لطلبات مفاتيح الشركاء والفنادق التجريبية والوصول المبكر.