دموی زنده

API اقامتی

API اقامت برای هتل، آپارتمان و ویلاهای تعطیلات

API اقامت هر نوع محل اقامت را به سایت رزرو شما می‌آورد: اتاق هتل، آپارتمان سرویس‌دار، خانه‌های تعطیلات، هاستل و مهمانپذیر. این صفحه داده‌های پشت یک اقامت، قواعدی که اجاره‌ها را از هتل‌ها متمایز می‌کند و روش فروش ملک‌های خودتان و موجودی تأمین‌کنندگان در یک جستجو توسط PHPTRAVELS را توضیح می‌دهد.

  • ملک، واحد، نرخ، تقویم
  • حداقل اقامت و هزینه‌ها
  • مهلت‌های لغو
  • موجودی اختصاصی به‌علاوه موجودی API

مدل داده

چهار لایه در هر اقامت

چه هتلی با ۳۰۰ اتاق باشد و چه یک خانه ساحلی، API اقامت آن را در همین چهار لایه تودرتو توصیف می‌کند. هر لایه به پرسش متفاوتی پاسخ می‌دهد که مهمان پیش از رزرو می‌پرسد.

01ملک

خود محل: نام، نوع، نشانی و موقعیت روی نقشه، عکس‌ها، امکانات، ستاره یا رده کیفی، قوانین اقامتگاه و ساعت‌های پذیرش.

property_id · type · address · geo · photos · amenities · check_in_from

02اتاق یا واحد

آنچه واقعاً رزرو می‌شود: یک نوع اتاق، یک آپارتمان کامل یا یک تخت در خوابگاه مشترک، با متراژ، تخت‌ها و حداکثر ظرفیت.

unit_id · beds · size_m2 · max_adults · max_children

03طرح نرخی

نحوه فروش آن واحد: وعده‌های غذایی، سیاست لغو، شرایط پرداخت و اینکه چه کسی می‌تواند رزرو کند، مثلاً عموم یا فقط آژانس‌ها.

rate_plan_id · board · cancel_policy · payment · channel

04موجودی

یک ردیف برای هر شب: قیمت، واحدهای باقی‌مانده، حداقل اقامت و اینکه ورود یا خروج در آن روز مجاز است یا نه.

date · price · units_left · min_stay · closed_to_arrival

یک ساختمان، یک اتاق، یک برچسب قیمت و یک تقویم که به‌صورت لایه‌های جدا و روی هم یک آگهی اقامتی را نشان می‌دهند

PHPTRAVELS ماژول اقامت خود را Stays می‌نامد، چون همین مدل بسیار بیشتر از هتل را پوشش می‌دهد. یک ملک چند واحد دارد، هر واحد با یک یا چند طرح نرخی فروخته می‌شود و هر طرح نرخی تقویمی شب‌به‌شب از قیمت و موجودی دارد. اگر این چهار لایه درست باشند، تخت هاستل، سوئیت هتل و ویلای سه‌خوابه همه در یک جستجو و یک پرداخت جا می‌شوند.

تأمین‌کنندگان لایه‌ها را با نام‌های متفاوت صدا می‌زنند و برخی دو لایه را ادغام می‌کنند، اما ساختار همیشه وجود دارد. هتل هر منبع را به آن نگاشت می‌کند تا مهمان یک صفحه یکدست ببیند.

شب‌به‌شب

تقویم موجودی جایی است که اقامت‌ها برده یا باخته می‌شوند

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

آپارتمان دوخوابه · نرخ استانداردنوامبر 2026 · قیمت هر شب
  1. 26
  2. 27
  3. 28
  4. 29
  5. 30
  6. 31
  7. 1120
  8. 2120
  9. 3
  10. 4
  11. 5
  12. 6165
  13. 7140
  14. 8120
  15. 9
  16. 10
  17. 11
  18. 123+165
  19. 13165
  20. 14140
  21. 15120
  22. 16120
  23. 17120
  24. 18
  25. 19
  26. 20165
  27. 21140
  28. 22120
  29. 23120
  30. 24120
  31. 25120
  32. 263+165
  33. 27165
  34. 28140
  35. 29120
  36. 30120
  37. 1
  38. 2
  39. 3
  40. 4
  41. 5
  42. 6
  • آزاد، با قیمت هر شب
  • قبلاً رزرو شده
  • بسته‌شده توسط مالک
  • حداقل اقامت برای ورود در این روز
  • ورود ممنوع

داده‌های نمونه، ساده‌شده

  • قیمت‌ها برای هر شب استجمع اقامت مجموع هر شب است، پس جمعه و شنبه با نرخ آخر هفته گران‌تر از دو روز میان‌هفته است. قیمت روزانه و فصلی در تقویم می‌ماند، نه در ملک.
  • قواعد حداقل اقامتحداقل سه شب برای ورود جمعه، واحد را از جستجوی دو شبه پنهان می‌کند. اجاره‌ها این قواعد را بسیار بیشتر از هتل‌ها به کار می‌برند و اغلب در آخر هفته و فصل شلوغ سخت‌گیرانه‌ترند.
  • بسته برای ورود یا خروجممکن است یک شب به‌عنوان بخشی از اقامت طولانی‌تر قابل رزرو باشد، اما نه به‌عنوان شب اول یا آخر. روزهای تعویض در خانه‌های تعطیلات این‌گونه کار می‌کنند.
  • شب‌های بسته و توقف فروشمالکان تاریخ‌ها را برای استفاده شخصی یا تعمیرات می‌بندند و توقف فروش، واحد را فوراً از فروش خارج می‌کند. هر شب بسته در بازه درخواستی، واحد را از نتایج حذف می‌کند.

هر اقامتی هتل نیست

هتل، آپارتمان و ویلای تعطیلات

مدل داده مشترک است، اما هر نوع اقامت آن را متفاوت پر می‌کند. این‌ها تفاوت‌هایی است که فرایند رزرو شما وقتی بیش از اتاق هتل می‌فروشد باید مدیریت کند.

هتل‌ها

از جمله هاستل‌ها و مهمانپذیرها

چه چیزی رزرو می‌شود
یک نوع اتاق با اتاق‌های یکسان فراوان، یا یک تخت در خوابگاه مشترک.
قیمت‌گذاری
نرخ هر شب برای هر اتاق و وعده غذایی؛ بزرگسال یا کودک اضافه ممکن است آن را تغییر دهد.
قواعد اقامت
حداقل اقامت فقط در تاریخ‌های اوج؛ بیشتر شب‌ها را می‌توان تکی رزرو کرد.
هزینه‌ها و ودیعه
مالیات شهری یا گردشگری، گاهی هزینه مجتمع که در محل پرداخت می‌شود.
ورود
پذیرش ۲۴ ساعته یا دارای کارکنان؛ ساعت‌های پذیرش روی واچر کافی است.
منبع معمول
بدبانک‌ها و عمده‌فروشان، قراردادهای مستقیم، چنل منیجرها.

آپارتمان‌های سرویس‌دار

هتل‌آپارتمان‌ها و آپارتمان‌های شهری

چه چیزی رزرو می‌شود
یک نوع واحد، اغلب با آشپزخانه و اتاق‌خواب‌های جدا.
قیمت‌گذاری
نرخ هر شب برای هر واحد، با قیمت هفتگی یا ماهانه برای اقامت‌های طولانی.
قواعد اقامت
حداقل اقامت رایج است و اقامت‌های طولانی بخش بزرگی از تقاضا را می‌سازند.
هزینه‌ها و ودیعه
هزینه نظافت برای هر اقامت و ودیعه قابل استرداد رایج است.
ورود
ساعت پذیرش متفاوت است؛ ورود دیروقت به جعبه کلید یا کد نیاز دارد.
منبع معمول
چنل منیجرها، قراردادهای مستقیم و برخی عمده‌فروشان.

اجاره‌های تعطیلات

خانه‌های تعطیلات، ویلاها و کابین‌ها

چه چیزی رزرو می‌شود
یک خانه مشخص. معمولاً فقط یکی از آن وجود دارد.
قیمت‌گذاری
نرخ هر شب برای کل خانه، به‌علاوه هزینه هر مهمان اضافه بر تعداد پایه.
قواعد اقامت
حداقل اقامت، روزهای تعویض ثابت و تاریخ‌های بسته برای ورود قاعده است.
هزینه‌ها و ودیعه
هزینه نظافت، ودیعه قابل استرداد خسارت و مالیات‌های محلی، هرکدام پیش از پرداخت نمایش داده می‌شود.
ورود
دستور پذیرش، نشانی و یک مخاطب پیش از ورود ارسال می‌شود، هرگز در صفحه عمومی نه.
منبع معمول
مالکان و مدیران ملک، مستقیم یا از طریق چنل منیجر.

به‌جای قراردادهای خودتان، خانه‌های میزبانان بسیاری را می‌فروشید؟ این یک بازارچه است که در صفحه پورتال BnB آمده است.

مهلت‌های سیاست لغو

یک رزرو، سه مهلت لغو

سیاست لغو یک خط زمانی است که از تاریخ ورود به عقب شمرده می‌شود. هر مهلت مشخص می‌کند مهمان در صورت لغو در آن بازه چه مبلغی پس می‌گیرد.

رزروپذیرش
  1. 01 · تا ۱۴ روز پیش از ورودلغو رایگانمهمان لغو می‌کند و کل مبلغ بازگردانده می‌شود. مسافران اول به دنبال همین مهلت می‌گردند، پس آن را به‌صورت تاریخ نشان دهید، نه قاعده.
  2. 02 · ۱۴ تا ۳ روز پیشجریمه جزئیجریمه‌ای اعمال می‌شود، اغلب شب اول یا درصدی از اقامت. اجاره‌ها ممکن است در این بازه ودیعه را نگه دارند.
  3. 03 · ۳ روز آخر و عدم حضورغیرقابل استردادکل مبلغ نگه داشته می‌شود. طرح‌های نرخی که غیرقابل استرداد فروخته می‌شوند از لحظه رزرو در همین بازه قرار دارند.
بازه‌های نمونه؛ هر طرح نرخی بازه‌های خودش را دارد.
  • برای هر طرح نرخی، نه هر ملکیک آپارتمان می‌تواند هم نرخ انعطاف‌پذیر و هم نرخ ارزان‌تر غیرقابل استرداد داشته باشد، پس سیاست به لایه طرح نرخی تعلق دارد.
  • تاریخ‌ها به منطقه زمانی ملک«۱۴ روز پیش» از تاریخ ورود در محل ملک شمرده می‌شود. آن را در صفحه و واچر به تاریخ و ساعت روشن تبدیل کنید.
  • سیاست تأمین‌کننده مقدم استبا موجودی API نمی‌توانید شرایطی ملایم‌تر از تأمین‌کننده ارائه دهید. با قراردادهای خودتان، بازه‌ها را خودتان تعیین می‌کنید.

موجودی اختصاصی و موجودی API

ملک‌های قراردادی شما و APIهای تأمین‌کنندگان در یک جستجو

بیشتر فروشندگان اقامت هر دو را انجام می‌دهند: محل‌هایی را که خودشان قرارداد بسته‌اند بارگذاری می‌کنند و برای بقیه APIهای تأمین‌کنندگان را اضافه می‌کنند. مسافر هرگز نباید بفهمد اقامت از کجا آمده است.

ملک‌های خودتان

  • ملک‌ها، واحدها و طرح‌های نرخی را خودتان در پنل مدیریت بارگذاری کنید
  • به مالکان و هتل‌ها ورود اکسترانت بدهید تا تقویم خود را مدیریت کنند
  • قیمت‌ها، حداقل اقامت، تاریخ‌های بسته و مهلت‌های لغو را تعیین کنید
  • آلوتمنت با روزهای آزادسازی و توقف فروش
  • یا نرخ و موجودی را از یک چنل منیجر دریافت کنید

موجودی API تأمین‌کنندگان

  • کاتالوگ‌های بزرگ در مقصدهایی که هرگز نمی‌توانید خودتان قرارداد ببندید
  • قیمت و موجودی زنده در لحظه جستجو
  • وعده‌های غذایی، سیاست‌ها و هزینه‌های تأمین‌کننده روی هر نرخ
  • با قرارداد و اعتبارنامه‌های خودتان نزد تأمین‌کننده فعال می‌شود
  • رزرو و لغو مستقیم به تأمین‌کننده ارسال می‌شود

آنچه مهمان می‌بیند

  • یک فهرست نتایج با یک صفحه ملک برای هر محل
  • یک اتاق از چند منبع فقط یک بار و با قیمت شما نمایش داده می‌شود
  • حاشیه سود شما بر اساس تأمین‌کننده، مقصد یا کانال و نرخ‌های B2B آژانس‌ها
  • یک قالب واچر، هر منبعی که رزرو را تأیید کرده باشد

اتصال چنل منیجر در یکپارچه‌سازی چنل منیجر آمده است. برای اتاق‌هایی که با قرارداد در اختیار دارید، سیستم موجودی رزرو را ببینید.

آماده در PHPTRAVELS

تأمین‌کنندگان Stays که هم‌اکنون متصل‌اند

این تأمین‌کنندگان اقامتی امروز به ماژول Stays متصل‌اند. شما با تأمین‌کننده قرارداد می‌بندید، اعتبارنامه‌های خودتان را در پنل وارد می‌کنید، در سندباکس او آزمایش می‌کنید و به‌صورت زنده می‌روید. فهرست به‌صورت زنده از دایرکتوری یکپارچه‌سازی‌های ما می‌آید.

تأمین‌کننده‌ای می‌خواهید که فهرست نیست، مثل یک شبکه اجاره منطقه‌ای؟ هر API اقامتی که مستندات داشته باشد قابل افزودن است، یکپارچه‌سازی API سفارشی را ببینید. برای انواع تأمین‌کنندگان هتل و نگاشت محتوا صفحه API هتل و راهنمای دو بدبانک بزرگ را بخوانید: یکپارچه‌سازی RateHawk API و یکپارچه‌سازی Hotelbeds API.

اقامت را همان‌طور رزرو کنید که مهمانانتان می‌کنند

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

دموی زنده را امتحان کنیددرباره تأمین‌کنندگانتان بپرسید

اپ خودتان یا فید شرکا را می‌سازید؟ REST API پلتفرم PHPTRAVELS همه منابع متصل Stays را در یک قالب ارائه می‌کند، با وب‌هوک برای رویدادهای رزرو. این امکان همراه طرح Enterprise است، قیمت‌ها و مستندات توسعه‌دهندگان را ببینید. تصویر کلی‌تر در APIهای سفر است.

پرسش‌های متداول

API اقامت: پرسش‌های توسعه‌دهندگان و آژانس‌ها

گفتگو با فروش

API اقامت مجموعه‌ای از سرویس‌های وب است که به سایت رزرو اجازه می‌دهد اقامتگاه‌ها را جستجو کند، قیمت و موجودی را برای تاریخ‌ها و مهمانان مشخص بخواند و رزرو ایجاد، مشاهده و لغو کند. هتل‌ها و هر نوع اقامت دیگر را پوشش می‌دهد: آپارتمان، اجاره تعطیلات، هاستل و مهمانپذیر.

فراخوانی‌های اصلی یکی است. API اقامت باید آنچه اقامتگاه‌های غیرهتلی لازم دارند را هم پوشش دهد: رزرو کل واحد، حداقل اقامت و روزهای تعویض، هزینه مهمان اضافه، هزینه نظافت، ودیعه قابل استرداد و دستور پذیرش که پیش از ورود ارسال می‌شود.

بله. در PHPTRAVELS ماژول Stays برای هر نوع اقامت از یک مدل ملک، واحد، طرح نرخی و موجودی استفاده می‌کند، پس هتل، آپارتمان و خانه تعطیلات با قواعد خودشان در یک جستجو ظاهر می‌شوند.

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

بله. می‌توانید ملک، واحد، طرح نرخی و تقویم را خودتان اضافه کنید، به مالکان ورود اکسترانت بدهید یا نرخ‌ها را از چنل منیجر بگیرید و آن‌ها را کنار موجودی تأمین‌کنندگان در یک فهرست نتایج بفروشید.

از طرح نرخی. موجودی تأمین‌کنندگان سیاست خود تأمین‌کننده را دارد و ملک‌های خودتان از بازه‌هایی که تعیین می‌کنید استفاده می‌کنند. مهلت پیش از پرداخت به مهمان نشان داده می‌شود و روی واچر چاپ می‌شود.

خیر. شما با هر تأمین‌کننده اقامتی قرارداد می‌بندید و اعتبارنامه‌های خودتان را در پنل وارد می‌کنید. PHPTRAVELS پلتفرم رزرو، ماژول Stays و کانکتورهای آماده را فراهم می‌کند.

بله. در طرح Enterprise، REST API پلتفرم PHPTRAVELS جستجو و رزرو را روی همه منابع متصل در یک قالب ارائه می‌کند، با وب‌هوک برای رویدادهای رزرو و کد منبع کامل برای توسعه.

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

بیشتر بدانید

بیشتر درباره پلتفرم