نمای کلی

Online Booking API موتور رزرو وب‌سایت خود هتل را به نرم‌افزار هتلداری HMS متصل می‌کند. فهرست اتاق‌ها و نرخ‌ها، تقویم ظرفیت، اعتبارسنجی کوپن، مرحله پرداخت و ارسال رزرو به HMS همگی از طریق این API انجام می‌شوند. این API برای آژانس‌هایی که موتور رزرو می‌سازند و برای شرکای تجاری 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 روز معتبر است و به یک هتل وابسته است. فهرست اتاق‌ها، اتاق‌ها و قیمت‌های قابل فروش را برای تاریخ‌ها و تعداد نفراتی که مهمان جست‌وجو کرده است برمی‌گرداند؛ پس از انتخاب مهمان و مشخص شدن روش پرداخت، رزرو به‌صورت BookingPushRQ در HMS ثبت می‌شود. راهنمای جریان رزرو همه مراحل را گام‌به‌گام شرح می‌دهد.

منابع#

منبع	اندپوینت‌ها
احراز هویت	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 باید با هتلی که توکن به آن وابسته است یکسان باشد.

نسخه#

این مستندات نسخه V2 از HMS API را پوشش می‌دهند. فیلدها و اندپوینت‌های جدید ممکن است بدون اطلاع قبلی اضافه شوند؛ کلاینت خود را طوری بنویسید که فیلدهای ناشناخته را نادیده بگیرد. تغییرات در یادداشت‌های انتشار فهرست می‌شوند.

گام‌های بعدی#

شروع سریعتوکن بگیرید و اولین جست‌وجوی اتاق را ارسال کنید. احراز هویتکلیدهای شریک تجاری و مدت اعتبار توکن. جریان رزرواز جست‌وجو تا ارسال رزرو، به‌طور کامل. مرجع APIهمه اندپوینت‌ها، پارامترها و نمونه‌ها.

آخرین به‌روزرسانی: 21 سپتامبر 2026اشتباهی دیدید؟ به ما اطلاع دهید