Advanced Search
Search Results
708 total results found
دریافت میزان اعتبار – Credit (بزودی)
گزارشات عملکرد – Account Report (بزودی)
API.php
این مستند نمای کلی مسیرهای API پروژه را ارائه میدهد که در معماری بکاند Laravel توسعه یافته است. ساختار بهصورت ماژولار طراحی شده و در قالب چند دامنه اصلی شامل Panel (v2)، B2C (v1)، Hub، AI و Core System پیادهسازی شده است. در بخش Panel (v2)، مسیرها تحت توکن...
مقدمات پایه ای
articles
Function getDetailsCharterItem
· هدف: این متد استاتیک یک ابزار داخلی قدرتمند برای استخراج و فرمتدهی جزئیات یک آیتم از چارتر است. بر اساس نوع (method) آیتم (مانند route, accommodation, visa, insurance, service)، متد دادههای خام ورودی را پردازش کرده و یک آبجکت ساختاریافته و تمیز را به...
Function getTableCharter
· هدف: این متد استاتیک به عنوان یک ابزار کمکی حیاتی برای تعیین نام جداول مرتبط با یک چارتر عمل میکند. با توجه به اینکه سیستم از جداول متفاوتی برای ذخیرهسازی رزروها و محاسبات بر اساس نوع چارتر (route یا accommodation) استفاده میکند، این تابع وظیفه دارد...
Function getConditionCharterItem
· هدف: این متد استاتیک به عنوان یک ابزار کمکی برای پردازش و استانداردسازی شرایط (Conditions) و خدمات (Services) مرتبط با یک آیتم محاسباتی چارتر عمل میکند. هدف اصلی آن، تبدیل آرایه خام ورودی از شرایط (که معمولاً از فرمهای فرانتاند میآید) به یک ساختار ...
Function listPlanCharter
· هدف: این متد برای واکشی و نمایش لیست پلنهای اتاقبندی (plan) مرتبط با یک چارتر اقامتی طراحی شده است. هدف اصلی آن، ارائه یک نمای کلی از تخصیص اتاقها به مسافران بر اساس یک پلن از پیش تعریفشده است. متد ابتدا چارتر را بر اساس شناسه پیدا کرده و بررسی می...
Function setRoomingPlanCharter
· هدف: این متد به عنوان نقطه پایانی برای تخصیص یک مسافر به یک اتاق خاص در یک پلن اتاقبندی عمل میکند. هدف اصلی آن، ثبت یا بهروزرسانی رکورد مربوط به “رومینگ” (تخصیص اتاق) در جدول charter_plans_rooming است. متد ابتدا بررسی میکند که آیا مسافر از قبل به ا...
Function deleteRoomingPlanCharter
· هدف: این متد برای حذف تخصیص یک مسافر از یک اتاق در یک پلن اتاقبندی (رومینگ) طراحی شده است. عملکرد آن بسیار ساده و مستقیم است: با دریافت شناسه پلن (plan_id) و شناسه رزرو مسافر (reserve_id)، رکورد متناظر را از جدول charter_plans_rooming حذف میکند. این ...
Function getAccommodationRooms
· هدف: این متد برای واکشی و نمایش وضعیت اتاقهای یک چارتر اقامتی در یک بازه زمانی مشخص طراحی شده است. هدف اصلی آن، ارائه یک نمای گرافیکی یا جدولی از در دسترس بودن اتاقها در طول زمان است. متد ابتدا یک دوره زمانی (CarbonPeriod) بین تاریخ شروع و پایان ورود...
Function setAccommodationRooms
· هدف: این متد برای تغییر وضعیت یک یا چند اتاق در یک چارتر اقامتی طراحی شده است. هدف اصلی آن، امکان خارج کردن اتاقها از دسترس (status = 2) یا بازگرداندن آنها به حالت در دسترس (status = 1) است. یک منطق امنیتی مهم در این متد وجود دارد: قبل از خارج کردن ی...
Function getCommunicationsCalculation
· هدف: این متد استاتیک یک ابزار کمکی برای واکشی جزئیات یک “آیتم محاسباتی” (Calculation Item) خاص است که در یک ارتباط (Communication) استفاده شده. هدف اصلی آن، فراهم کردن اطلاعات لازم برای نمایش جزئیات آیتم (مانند کلاس پرواز یا نوع واگن قطار) در UI مدیریت...
Function getCommunicationsCharter
· هدف: این متد استاتیک برای واکشی اطلاعات اولیه و ضروری یک چارتر برای استفاده در ماژول “ارتباطات” (Communications) طراحی شده است. هدف آن، فراهم کردن یک لیست از آیتمهای محاسباتی (کلاسها/اتاقها) موجود در آن چارتر به همراه اطلاعات کلی چارتر (مانند مبدأ، ...
Function updateCharterReservation
· هدف: این متد برای ویرایش اطلاعات رزرو یک یا چند مسافر به صورت همزمان استفاده میشود. کاربر میتواند اطلاعات هویتی (مانند نام، کد ملی)، اطلاعات تماس (ایمیل، موبایل) و یا حتی وضعیت رزرو (مثلاً تغییر از حالت موقت به قطعی) را برای لیستی از رزروها تغییر دهد...
Function deleteCharterReservation
· هدف: این متد برای حذف منطقی (Soft Delete) یک یا چند رزرو از یک چارتر مشخص به کار میرود. به جای حذف فیزیکی رکوردها از دیتابیس، این تابع ستون deleted_at را برای رزروهای انتخاب شده با زمان حال پر میکند. این کار به سیستم اجازه میدهد تا رزروها را آرشیو ک...
Function operationWarrantyCharter
· هدف: این متد به منظور مدیریت گارانتیکنندگان (تضامین) یک چارتر خاص طراحی شده است. بر اساس پارامتر action که در درخواست ارسال میشود، این تابع میتواند یک یا چند گارانتیکننده جدید را به چارتر اضافه کند (add) یا گارانتیکنندگان موجود را از آن حذف نماید ...
Function listServicesCharter
· هدف: این متد لیستی از سرویسهای قابل ارائه در سیستم را بر اساس نوع چارتر (مسیر یا اقامتگاه) فیلتر کرده و برمیگرداند. این سرویسها میتوانند شامل مواردی مانند ترانسفر فرودگاهی، وعدههای غذایی، بیمه مسافرتی و… باشند. این تابع به پنل کاربری کمک میکند تا...
Function storeRefundCharterReservation
· هدف: این متد فرآیند استرداد (Refund) یک یا چند رزرو را مدیریت میکند. این تابع به صورت دستهای عمل کرده و میتواند لیستی از رزروها را دریافت و برای هر یک، عملیات استرداد را بر اساس قوانین و جریمههای تعریف شده انجام دهد. این تابع با محاسبه مبلغ جریمه، ...
داشتن سرویس با قابلیت هاب ایرپلاس
یکی دیگر از پیش نیاز های اتصای به سرویس چارتری داشتن سرویس با قابلیت هاب ایرپلاس از مجموعه می باشد. این سرویس پس از گذراندن مراحل مختلف اخذ و پس از آن میتوانید از طریق پنل درخواست ارتباط خود را ارسال فرمائید.
تعاریف و اصطلاحات استفاده شده در مستندات
لطفا در هنگام استفاده از مستندات، تعاریف زیر را مد نظر داشته باشید: تامین کننده: منظور آژانس مسافرتی و یا سرویس است که شما در حال استفاده از API آن می باشید. پروازهای چارتری: به پروازهایی گفته می شود که تامین کننده مالک سهمیه و نرخ آن پرواز می باشد. پروازه...
نکات کلی و ابتدایی راه اندازی سرویس
پیش نیاز کار با این سرویس داشتن دانش فنی مانند (Rest-full API, JWT Authentication) و آشناییت کامل با عملیات های چارتری و رزرو بلیت، هتل و خدمات. جهت استفاده از سرویس ایرپلاس، نیاز است که IP شما در هسته مرکزی Trust گردد. Trust کردن تا 2 عدد IP به صورت رایگان...
Header های اجباری برای تمامی درخواست ها
لطفا دقت نموده که به همراه تمامی درخواست های خود، header های زیر را نیز ارسال نمای HTTP //(required) - 1 Content-Type: application/json; charset=utf-8 //(required) - 2 Accept: application/json //(required) - 3 Accept-Encoding: gzip, deflate استفا...
استفاده از Https و TLS
تمام در خواست های ارسالی به هسته مرکزی الزاما باید از بستر HTTPS استفاده نمایند. و درخواست های بدون SSL و روی بستر HTTP را پشتیبانی نمی شود. همچنین زمان ارسال درخواست حتما از Tls ورژن 1.2 استفاده کنید. اینکار در .Net به صورت زیر انجام می شود: System.Net.Serv...