نرمافزار خودتان را به ماژولهای HMS متصل کنید
مستندات API جداگانه برای هر ماژول نرمافزار هتلداری: موتور رزرو، وایفای مهمان، POS رستوران، اسپا، تلویزیون، سانترال و سرویسهای هوش مصنوعی. APIهای Online Booking و Hotspot هماکنون منتشر شدهاند؛ بقیه بهترتیب اضافه میشوند.
- احراز هویت
- توکن
Bearerیا هدرApiKey - قالب
- پاسخهای JSON با پوشش
success - منتشرشده
- 2 محصول · 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
وایفای مهمان و ثبت لاگ طبق قانون 5651
فهرست مهمانان مقیم هتل را در اختیار سیستم هاتاسپات قرار میدهد: اتاق، هویت، زمان چکاین و چکاوت. برای تأیید ورود مهمان به وایفای با شماره اتاق و نگهداری لاگهای دسترسی طبق قانون شماره 5651 ترکیه.
POS رستوران
فیشها و ثبت هزینه روی اتاق
انتقال فیشهای رستوران، بار و کافه به صورتحساب اتاق و همگامسازی منو و موجودی انبار.
Spa
نوبتدهی و فروش خدمات
نوبتهای اسپا و ولنس، کاتالوگ خدمات و یکپارچهسازی با ثبت هزینه روی اتاق.
هوش مصنوعی
سرویسهای دستیار و پیشنهاددهی
دسترسی به سرویسهای هوش مصنوعی برای دستیار مهمان، پیشنهاد نرخ و گزارشگیری.
TV
سیستمهای تلویزیون داخل اتاق
اطلاعات مهمان، صورتحساب، پیامها و درخواستهای خدمات برای رابط تلویزیون اتاق.
سانترال
سانترال و سوابق تماس
یکپارچهسازی با سانترال تلفن: فعال و غیرفعال کردن خطوط هنگام چکاین و چکاوت، ثبت هزینه تماسها در صورتحساب اتاق.
اصول مشترک همه محصولات
اگر یک ماژول را یکپارچه کرده باشید، بقیه برایتان آشنا خواهند بود.
کلید وابسته به هتل
در 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 منتشر شدجدیدجدیدجدید
به مشکل خوردید؟
تیم توسعهدهندگان ما ظرف یک روز کاری پاسخ میدهد.
بدنه درخواست (با کلیدهای محرمانه و داده کارت پوشاندهشده)، پاسخ و زمان را ضمیمه کنید. برای کلید شریک تجاری، هتل آزمایشی و دسترسی زودهنگام هم از همین آدرس استفاده کنید.