Online Booking API

منتشرشدهHMS API V2API موتور رزرو

موتور رزرو وب‌سایت هتل را به HMS متصل می‌کند: فهرست اتاق و نرخ، تقویم ظرفیت، کوپن، پرداخت و ارسال رزرو.

شروع سریع مرجع API
آدرس پایه
https://test.hms.gen.tr
احراز هویت
apiKey / apiSecret ← توکن Bearer
قالب
پاسخ JSON · بدنه درخواست به‌صورت فرم یا JSON
دامنه
8 منبع · 16 اندپوینت

منابع#

احراز هویت

1 اندپوینت

دسترسی به Online Booking API با اطلاعات دسترسی شریک تجاری انجام می‌شود که HMS صادر می‌کند. اندپوینت لاگین در ازای apiKey و apiSecret یک توکن برمی‌گردا…

  • POST/external/public/login

اتاق‌ها و نرخ‌ها

2 اندپوینت

دو اندپوینت که نتایج جست‌وجوی موتور رزرو را تأمین می‌کنند: فهرست اتاق‌ها که انواع اتاق قابل فروش، انواع پذیرایی و قیمت‌ها را برای تاریخ‌ها و تعداد نفر…

  • POST/external/online/roomType
  • GET/external/room/type/hotel/availability

رزرو

1 اندپوینت

اتاق، نوع پذیرایی و نرخی که مهمان انتخاب کرده است در ساختار BookingPushRQ به HMS ارسال می‌شود. همین اندپوینت با ارسال type برابر Cancel یا Modify لغو …

  • POST/external/online/channel/booking

پرداخت

3 اندپوینت

روش‌های پرداختی را که هتل برای رزرو آنلاین می‌پذیرد فهرست می‌کند و مرحله پرداخت را برای روش انتخاب‌شده آغاز می‌کند. کارهای لازم برای هر روش در راهنمای…

  • GET/external/online/payment/type
  • GET/external/payment/company
  • POST/external/online/payment/type/{paymentType}

کوپن

1 اندپوینت

کوپن‌های تخفیف آنلاینی را که هتل در پنل تعریف کرده است اعتبارسنجی می‌کند. تخفیف را در سمت خودتان اعمال کنید و مبالغ تخفیف‌خورده را در ارسال رزرو بفرست…

  • POST/external/online/coupon/search

پکیج‌ها و خدمات اضافی

1 اندپوینت

خدمات اضافی که همراه رزرو قابل فروش‌اند: پکیج‌های اتاق (وابسته به یک نوع اتاق) و پکیج‌های عمومی (ترانسفر، شام، اسپا). پکیج‌های فروخته‌شده در ارسال رزر…

  • GET/external/stock/packages

اطلاعات هتل

4 اندپوینت

داده‌هایی که قالب صفحات موتور رزرو را پر می‌کنند: اطلاعات تماس و موقعیت، پیوندهای شبکه‌های اجتماعی، متن‌های فوتر (متن‌های حقوقی، درباره هتل، کدهای Ana…

  • GET/external/hotel/{hotelID}/contact/info
  • GET/external/online/social/media
  • GET/external/online/footer
  • +1 مورد دیگر

داده‌های پایه

3 اندپوینت

فهرست‌های ثابت برای گزینه‌های فرم: کشورها، ارزها و زبان‌ها. به‌ندرت تغییر می‌کنند و می‌توان آن‌ها را تا یک روز کش کرد.

  • POST/external/counties
  • GET/external/currencies
  • GET/external/languages

مستندات#

شروع کار

راهنماها

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