GET /v2/core/accommodation/view

Core Accommodation View 

 این اندپوینت اطلاعات کامل یک اقامتگاه را بر اساس شناسه ارسال‌شده بازگردانی می‌کند. داده‌های هتل، اطلاعات کشور/استان/شهر، مدیا (لوگو + گالری)، جزئیات، امکانات، برد، اطلاعات مدیریت و Mapping Supplierها به‌صورت کامل تجمیع و استانداردسازی می‌شود. 

 

 Request Overview 

 

 

 URL: /v2/core/accommodation/view 

 Method: GET 

 Controller: CoreController@viewAccommodation 

 Middleware Stack: authWithJwt → core 

 

 

 Access Control 

 

 

 JWT معتبر 

 middleware core → شرط: operator.branch == "[0]" 

 

 

 Request Parameters 

 

 

 

 

 Field 

 Type 

 Required 

 Description 

 

 

 

 

 id 

 integer 

 yes 

 ID اقامتگاه برای مشاهده 

 

 

 

 

 Lookup Logic 

 

 

 دریافت رکورد اصلی از جدول hotels . 

 اگر country مقدار null باشد → مقدار پیش‌فرض 118. 

 واکشی اطلاعات:

 

 countries (با nationality) 

 states 

 cities 

 

سپس تبدیل ساختار به فرمت استاندارد front‑end:

 

 title.fa و title.en 

 icon → ISO 

 

 

 واکشی Mapping از جدول mapping_accommodations :

 

 اگر رکورد وجود داشته باشد: id, accommodation, status حذف می‌شود 

 هر مقدار null → false 

 اگر رکورد نبود → خروجی: false 

 

 

 واکشی Media از جدول media :

 

 type = logo → ذخیره در logo 

 type != logo → ورود به آرایه media[] 

 اگر هیچ رسانه‌ای وجود نداشت:

 

 logo = null 

 media = [] 

 

 

 

 

 Decode کردن:

 

 details 

 board 

 possibilities 

 

 

 تجمیع نهایی در آرایه $return و بازگشت. 

 

 

 Response (Success) 

 {

 "status": true,

 "time": 1710000000,

 "data": {

 "title": {

 "fa": "...",

 "en": "..."

 },

 "type": "...",

 "rate": 4,

 "country": {

 "id": 118,

 "icon": "IR",

 "title": { "fa": "...", "en": "..." },

 "nationality": { "fa": "...", "en": "..." }

 },

 "state": { "id": 1, "title": { "fa": "...", "en": "..." } },

 "city": { "id": 2, "title": { "fa": "...", "en": "..." } },

 "phone": "...",

 "mobile": "...",

 "email": "...",

 "site": "...",

 "address": "...",

 "location": "...",

 "logo": "... or false",

 "media": ["..."] or false,

 "details": {...},

 "board": [...],

 "possibilities": [...],

 "leader_name": "...",

 "leader_mobile": "...",

 "description": "...",

 "confirm_status": 1,

 "priority": 10,

 "mapping": {

 "tport": true|false,

 "sepehr": true|false,

 "snapptrip": true|false,

 "alibaba": true|false,

 "eghamat24": true|false,

 "iranhotelonline": true|false

 },

 "status": 1

 }

}

 

 

 Response (Error) 

 {

 "status": false,

 "code": "1003",

 "message": "(Exception message)",

 "trace": [...]

}

 

 

 Flowchart 

 

 

 Validate JWT & Core Access 

 ↓ 

 Read id 

 ↓ 

 SELECT * FROM hotels WHERE id=? 

 ↓ 

 Fetch & Normalize Country 

 ↓ 

 Fetch State & City 

 ↓ 

 Fetch Mapping → Convert null→false 

 ↓ 

 Fetch Media → logo + media[] 

 ↓ 

 Decode details/possibilities/board 

 ↓ 

 Assemble Response Payload 

 ↓ 

 Return JSON