bulk-availability
متد GetClosedFlights
این متد برای بدست آوردن پروازهای عدم موجود و Close شده یک تامین کننده استفاده می شود.
استفاده از این متد اختیاری می باشد.
کاربر این متد برای زمانی است که شما می خواهید پروازهای Close شده را به مسافر خود نمایش دهید.
API Endpoint
POST https://{SupplierWebsiteUrl}/api/Partners/Flight/BulkAvailability/V18/GetClosedFlights
Request Parameters
Usernamestring
required
نام کاربری
در صورتی که شما یک موتور جستجو هستید و قصد فروش نداشته و فقط می خواهید اطلاعات پروازهای عمومی را بدست آورید، نام کاربری را public ارسال نمایید.
Passwordstring
required
رمز عبور به صورت MD5 شده
FromDatestring
required
تاریخ شروع برای فیلتر کردن پروازها با فرمت yyyy-MM-dd میلادی.
ToDatestring
required
تاریخ پایان برای فیلتر کردن پروازها با فرمت yyyy-MM-dd میلادی.
FlightSourcestring enum
required
این فیلد تعیین میکند که درخواست شما چه نوع پروازهایی را برگرداند. مقدار این فیلد میتواند یکی از گزینههای زیر باشد:
All
تمامی پروازهای موجود (چه متعلق به تأمینکننده مورد درخواست و چه دریافتشده از سایر تأمینکنندگان).
OwnedFlight
فقط پروازهایی که تأمینکنندهای که به آن درخواست ارسال کردهاید مالک نرخ و ظرفیت آنهاست.
ThirdPartyFlight
فقط پروازهایی که تأمینکننده مورد درخواست، مالک نرخ و ظرفیت آنها نیست و آنها را از طریق وبسرویس از تأمینکننده دیگری دریافت کرده است (پروازهای وب سرویسی یا واسطهای).
در زمان استفاده از سپهرهاب، مقدار این فیلد باید All یا ThirdPartyFlight ارسال شود.
Culturestring enum
required
مشخصکننده زبان متنهای بازگشتی در پاسخ سرویس. مقادیر پذیرفته شده عبارتند از: fa-IR ، en-US و ar-IQ
Sample Request
{
"UserName": "testdev1",
"Password": "25f9e794323b453885f5181f1b624d0b",
"FromDate": "2026-05-26",
"ToDate": "2027-05-29",
"FlightSource": "All",
"Culture": "fa-IR"
}
Response Parameters
ClosedFlightListList of ClosedFlight
لیستی از پروازهای Close
ClosedFlightList.FlightNumberstring
شماره پرواز
ClosedFlightList.DepartureDateTimestring
تاریخ پرواز با فرمت yyyy-MM-dd HH:mm به زمان محلی مبدا
ClosedFlightList.OriginComplex type
کد یاتای سه حرفی فرودگاه مبدا
ClosedFlightList.DestinationComplex type
کد یاتای سه حرفی فرودگاه مقصد
ClosedFlightList.Aircraftstring
کد یاتای نوع هواپیما.
جهت مشاهده کد یاتا انواع هواپیما اینجا کلیک نمایید
ClosedFlightList.ArrivalDateTimestring
زمان رسیدن پرواز به مقصد با فرمت yyyy-MM-dd HH:mm به زمان محلی مقصد
ClosedFlightList.Durationnumber
طول مدت پرواز بر حسب دقیقه
در صورتی که در سیستم خود طول مدت پرواز را نمایش می دهید، بهتر است به جای بدست آوردن تفاوت بین DepartureDateTime و ArrivalDateTime، از مقدار این فیلد استفاده نمایید. زیرا بدست آوردن تفاوت بر اساس DepartureDateTime و ArrivalDateTime نیازمند در نظر گرفتن ناحیه زمانی مبدا و مقصد بوده و یا حتی در مواردی که مبدا و مقصد یکسان بوده ولی ساعت ها تغییر کنند (مانند اول فروردین یا اول مهرماه) بدست آوردن این تفاوت، نیازمند عملیات پیچیده است. بنابراین بهتر است از مقدار این فیلد استفاده نمایید.
ClosedFlightList.Airlinestring
کد یاتا ایرلاین
ClosedFlightList.Remarksstring
اگر تامین کننده توضیحاتی در خصوص این پرواز ثبت کرده باشد، این توضیحات به صورت متن در این فیلد خروجی داده می شود.
عموما شما نیازی به استفاده از این فیلد نخواهید داشت و می توانید آن را نادیده بگیرید.
ClosedFlightList.Sourcestring enum
این فیلد نشان میدهد پروازِ برگرداندهشده از چه نوع منبعی تأمین شده است (از نظر مالکیت نرخ و ظرفیت). مقدار این فیلد یکی از گزینههای زیر است:
Owned
تأمینکنندهای که به آن درخواست دادهاید، مالک مستقیمِ نرخ و ظرفیت این پرواز است؛ یعنی یا خودِ ایرلاین است که پرواز را در سیستم رزرواسیون سپهر ایجاد کرده، یا چارترکننده اصلی.
ThirdParty
تأمینکنندهای که به آن درخواست دادهاید، مالک نرخ و ظرفیت این پرواز نیست و صرفاً نقش واسط دارد؛ یعنی پرواز را از طریق وبسرویس از تأمینکننده دیگری دریافت کرده و ارائه میکند.
ClosedFlightList.Stop1Complex type
در صورتی که پرواز دارای Stop باشد، اطلاعات اولین توقف در این فیلد خروجی داده خواهد شد.
در پروازهای Stop دار، در زمان توقف، مسافر از هواپیما پیاده نشده و همچنین نیازی به جابجایی بار نیست. معمولا این گونه توقف ها بابت پیاده یا سوار کردن مسافران جدید یا سوخت گیری انجام می پذیرد. و در هر صورتی مسافران قبلی در زمان توقف در هواپیما باقی مانده و نیازی به ترک هواپیما نمی باشد.
ClosedFlightList.Stop1.AirportIataCodestring
کد یاتا فرودگاه محل توقف
ClosedFlightList.Stop1.FlightDurationUntilThisStopInMinutenumber
طول مدت پرواز تا رسیدن به فرودگاه محل توقف.
مقدار این فیلد بر اساس دقیقه می باشد.
ClosedFlightList.Stop1.StopDurationInMinutenumber
طول مدت توقف در فرودگاه
مقدار این فیلد بر اساس دقیقه می باشد.
ClosedFlightList.Stop1.ArrivalDateTimestring
زمان ورود به فرودگاه محل توقف
بر اساس زمان محلی و با فرمت yyyy-MM-dd HH:mm
ClosedFlightList.Stop1.DepartureDateTimestring
زمان خروج از فرودگاه محل توقف
بر اساس زمان محلی و با فرمت yyyy-MM-dd HH:mm
ClosedFlightList.Stop2Complex type
در صورتی که پرواز دارای بیش از یک Stop باشد، اطلاعات مربوط به توقف دوم توسط این فیلد خروجی داده می شود.
ساختار فرمت آن مشابه فیلد Stop1 می باشد.
Sample Response
{
"ClosedFlightList": [{
"FlightNumber": "111",
"DepartureDateTime": "2026-05-26 12:00",
"Origin": "MHD",
"Destination": "THR",
"Aircraft": "100",
"ArrivalDateTime": "2026-05-26 13:10",
"Duration": 70,
"Airline": "QB",
"Remarks": "",
"Source": "Owned",
"Stop1": null,
"Stop2": null
}, {
"FlightNumber": "513",
"DepartureDateTime": "2026-05-26 01:30",
"Origin": "SAW",
"Destination": "IKA",
"Aircraft": "M80",
"ArrivalDateTime": "2026-05-26 05:40",
"Duration": 220,
"Airline": "W5",
"Remarks": "",
"Source": "Owned",
"Stop1": null,
"Stop2": null
},
// ... بیشتر پروازها
]
}