#P1461
Route: GET /api/v2/online/accommodation/list
Route Info
| Method |
Endpoint |
Controller |
Middleware |
Purpose |
| GET |
/api/v2/online/accommodation/list |
OnlineController@listAccommodation |
authWithJwt |
لیست اقامتگاههای قابل نمایش در سیستم Online Booking |
منطق عملکرد
- به صورت مستقیم فراخوانی
BaseService::listAccommodation($request).
- مدیریت فیلترها (شهر، تاریخ، ظرفیت، قیمت و …) در لایه سرویس.
- بازگردانی ساختار اطلاعات در قالب JSON از پاسخ سرویس داخلی.
ورودیها
| پارامتر |
نوع |
توضیح |
| city |
string |
شهر اقامتگاه (مثلاً SHZ یا 'شیراز') |
| check_in |
date |
تاریخ ورود |
| check_out |
date |
تاریخ خروج |
| guest_count |
integer |
تعداد مسافران |
| branch |
integer |
شناسه شعبه ارسالکننده |
پاسخ نمونه موفق
{
"status": true,
"timestamp": 1732050600,
"payload": [
{"hotel":"Homa Hotel","city":"Shiraz","stars":5,"rooms":[...]},
{"hotel":"Persepolis","city":"Shiraz","stars":4}
]
}
وابستگیها
BaseService::listAccommodation()- منابع داخلی اقامتگاهها (جدول
accommodations یا API third‑party)
یادداشت توسعه
- افزودن پارامتر
sort_by برای مرتبسازی بر اساس قیمت یا ستاره.
- در نسخه بعد، کش نتایج به مدت ۶۰ ثانیه پیشنهاد میشود.
