پورتال توسعه‌دهندگاننرم‌افزار هتلداری HMS

نرم‌افزار خودتان را به ماژول‌های 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"
پاسخ · 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

وای‌فای مهمان و ثبت لاگ طبق قانون 5651

فهرست مهمانان مقیم هتل را در اختیار سیستم هات‌اسپات قرار می‌دهد: اتاق، هویت، زمان چک‌این و چک‌اوت. برای تأیید ورود مهمان به وای‌فای با شماره اتاق و نگهداری لاگ‌های دسترسی طبق قانون شماره 5651 ترکیه.

1 منبع · 1 اندپوینتمستندات
به‌زودی

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
    مستندات Hotspot API منتشر شد
    جدیدجدید
  • Online Booking
    مستندات Online Booking API منتشر شد
    جدیدجدیدجدید

به مشکل خوردید؟

تیم توسعه‌دهندگان ما ظرف یک روز کاری پاسخ می‌دهد.

بدنه درخواست (با کلیدهای محرمانه و داده کارت پوشانده‌شده)، پاسخ و زمان را ضمیمه کنید. برای کلید شریک تجاری، هتل آزمایشی و دسترسی زودهنگام هم از همین آدرس استفاده کنید.