پشتیبانی
برای هر مشکلی که یکپارچهسازی شما را متوقف کرده است با تیم توسعهدهندگان ما در تماس باشید. پیشنهاد میکنیم ابتدا صفحه کدهای خطا محصول را بررسی کنید؛ پاسخ بیشتر پرسشها آنجاست.
ایمیل
پرسشهای فنی، گزارش باگ، درخواست کلید شریک تجاری و هتل آزمایشی. ظرف یک روز کاری پاسخ داده میشود.
تلفن
دوشنبه تا جمعه، 09:00–18:00 (GMT+3). برای قطعیهایی که محیط عملیاتی را تحت تأثیر قرار میدهند.
کلید شریک تجاری
دسترسی نیازمند حساب شریک تجاری است که HMS صادر میکند. مشخصات شرکت و هتلهایی را که یکپارچه خواهید کرد برای ما ایمیل کنید؛ برای محیط آزمایشی یک apiKey، یک apiSecret و یک شناسه هتل دریافت خواهید کرد.
هنگام گزارش مشکل، این موارد را ضمیمه کنید
- محصول و اندپوینت (مثلاً Online Booking ·
POST /external/online/roomType) - بدنه کامل درخواست و پاسخ، با
apiSecret، توکن و داده کارت پوشاندهشده - زمان ارسال درخواست (با منطقه زمانی) و
hotelID - نتیجهای که انتظار داشتید و اینکه آیا مشکل قابل تکرار است
پرسشهای متداول
برای استفاده از API به چه چیزی نیاز دارم؟
یک حساب شریک تجاری صادرشده توسط HMS (apiKey / apiSecret) و مجوز دسترسی به هتلی که یکپارچه میکنید. ماژول مربوطه (مثلاً کانال رزرو آنلاین) باید در سمت هتل فعال باشد.
آیا محیط آزمایشی وجود دارد؟
بله. نمونههای این مستندات از محیط آزمایشی (test.hms.gen.tr) استفاده میکنند؛ برای توسعه، یک رکورد هتل و کلید شریک تجاری در این محیط در اختیارتان قرار میگیرد. آدرس و کلیدهای محیط عملیاتی پس از تأیید یکپارچهسازی صادر میشوند.
خطای 401 میگیرم.
توکن ارسال نشده، منقضی شده، پیشوند Bearer را ندارد یا متعلق به هتل دیگری است. دوباره لاگین کنید و درخواست را تکرار کنید. اگر لاگین success: false برگرداند، message را بررسی کنید: جفت کلید اشتباه است یا مجوز هتل وجود ندارد.
فهرست اتاقها خالی است یا roomCount برابر 0 است.
کانال آنلاین هتل بسته است (errorCode 10003)، هیچ نوع اتاقی برای فروش باز نیست (10004) یا محدودیتهای تاریخ/تعداد نفرات اعمال میشود. برای اتاقهایی با roomCount برابر 0، فیلد roomRestrictionMessage دلیل را مشخص میکند (حداقل اقامت، بسته بودن برای ورود، تعریفنشدن نرخ).
رزرو را ارسال کردم اما در پنل نمایش داده نمیشود.
وجود Error را در BookingPushRS بررسی کنید. Hotel registration not found on HMS. یعنی هتل به کانال آنلاین متصل نیست؛ Could not register. معمولاً یعنی roomTypeID / ratePlanID نامعتبر یا تاریخهای ناسازگار ارسال شده است.
API ماژولهای دیگر کی منتشر میشود؟
مستندات POS رستوران، Spa، هوش مصنوعی، TV و سانترال بهترتیب اضافه میشوند. تاریخهای انتشار در یادداشتهای انتشار اعلام میشود؛ برای دسترسی زودهنگام به یک ماژول مشخص به ما پیام دهید.