GetClosedFlights – Sepehr Integration Docs

Bulk Availability

متد GetClosedFlights

این متد برای بدست آوردن پروازهای عدم موجود و Close شده یک تامین کننده استفاده می شود.

استفاده از این متد اختیاری می باشد.

کاربر این متد برای زمانی است که شما می خواهید پروازهای Close شده را به مسافر خود نمایش دهید.

API Endpoint

https://{SupplierWebsiteUrl}/api/Partners/Flight/BulkAvailability/V18/GetClosedFlights post

Request Parameters

نمونه کلاس Request به زبان سی شارپ در پروژه Partners.Contracts (دانلود) در پوشه زیر موجود است:

\Flight\BulkAvailability\V18\GetClosedFlights\RequestModel

Username

string

required

نام کاربری

در صورتی که شما یک موتور جستجو هستید و قصد فروش نداشته و فقط می خواهید اطلاعات پروازهای عمومی را بدست آورید، نام کاربری را public ارسال نمایید.

Password

string

required

رمز عبور به صورت MD5 شده

FromDate

string

required

تاریخ شروع برای فیلتر کردن پروازها با فرمت yyyy-MM-dd میلادی.

ToDate

string

required

تاریخ پایان برای فیلتر کردن پروازها با فرمت yyyy-MM-dd میلادی.

FlightSource

string enum

required

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

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

OwnedFlight
فقط پروازهایی که تأمین‌کننده‌ای که به آن درخواست ارسال کرده‌اید مالک نرخ و ظرفیت آن‌هاست.

ThirdPartyFlight
فقط پروازهایی که تأمین‌کننده مورد درخواست، مالک نرخ و ظرفیت آن‌ها نیست و آن‌ها را از طریق وب‌سرویس از تأمین‌کننده دیگری دریافت کرده است (پروازهای وب سرویسی یا واسطه‌ای).

در زمان استفاده از سپهرهاب، مقدار این فیلد باید All یا ThirdPartyFlight ارسال شود.

Culture

string enum

required

مشخص‌کننده زبان متن‌های بازگشتی در پاسخ سرویس. مقادیر پذیرفته شده عبارتند از: fa-IR ، en-US و ar-IQ

{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "FromDate": "2026-05-26",
    "ToDate": "2027-05-29",
    "FlightSource": "All",
    "Culture": "fa-IR"
}

Response Data

نمونه کلاس Response به زبان سی شارپ در پروژه Partners.Contracts (دانلود) در پوشه زیر موجود است:

\Flight\BulkAvailability\V18\GetClosedFlights\ResponseModel

ClosedFlightList

List of ClosedFlight

لیستی از پروازهای Close

FlightNumber

string

شماره پرواز

DepartureDateTime

string

تاریخ پرواز با فرمت yyyy-MM-dd HH:mm به زمان محلی مبدا

Origin

Complex type

کد یاتای سه حرفی فرودگاه مبدا

Destination

Complex type

کد یاتای سه حرفی فرودگاه مقصد

Aircraft

string

کد یاتای نوع هواپیما.

جهت مشاهده کد یاتا انواع هواپیما اینجا کلیک نمایید

ArrivalDateTime

string

زمان رسیدن پرواز به مقصد با فرمت yyyy-MM-dd HH:mm به زمان محلی مقصد

Duration

number

طول مدت پرواز بر حسب دقیقه

در صورتی که در سیستم خود طول مدت پرواز را نمایش می دهید، بهتر است به جای بدست آوردن تفاوت بین DepartureDateTime و ArrivalDateTime، از مقدار این فیلد استفاده نمایید. زیرا بدست آوردن تفاوت بر اساس DepartureDateTime و ArrivalDateTime نیازمند در نظر گرفتن ناحیه زمانی مبدا و مقصد بوده و یا حتی در مواردی که مبدا و مقصد یکسان بوده ولی ساعت ها تغییر کنند (مانند اول فروردین یا اول مهرماه) بدست آوردن این تفاوت، نیازمند عملیات پیچیده است. بنابراین بهتر است از مقدار این فیلد استفاده نمایید.

Airline

string

کد یاتا ایرلاین

Remarks

string

اگر تامین کننده توضیحاتی در خصوص این پرواز ثبت کرده باشد، این توضیحات به صورت متن در این فیلد خروجی داده می شود.

عموما شما نیازی به استفاده از این فیلد نخواهید داشت و می توانید آن را نادیده بگیرید.

Source

string enum

این فیلد نشان می‌دهد پروازِ برگردانده‌شده از چه نوع منبعی تأمین شده است (از نظر مالکیت نرخ و ظرفیت). مقدار این فیلد یکی از گزینه‌های زیر است:

Owned
تأمین‌کننده‌ای که به آن درخواست داده‌اید، مالک مستقیمِ نرخ و ظرفیت این پرواز است؛ یعنی یا خودِ ایرلاین است که پرواز را در سیستم رزرواسیون سپهر ایجاد کرده، یا چارترکننده اصلی.

ThirdParty
تأمین‌کننده‌ای که به آن درخواست داده‌اید، مالک نرخ و ظرفیت این پرواز نیست و صرفاً نقش واسط دارد؛ یعنی پرواز را از طریق وب‌سرویس از تأمین‌کننده دیگری دریافت کرده و ارائه می‌کند.

Stop1

Complex type

در صورتی که پرواز دارای Stop باشد، اطلاعات اولین توقف در این فیلد خروجی داده خواهد شد.

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

AirportIataCode

string

کد یاتا فرودگاه محل توقف

FlightDurationUntilThisStopInMinute

number

طول مدت پرواز تا رسیدن به فرودگاه محل توقف.

مقدار این فیلد بر اساس دقیقه می باشد.

StopDurationInMinute

number

طول مدت توقف در فرودگاه

مقدار این فیلد بر اساس دقیقه می باشد.

ArrivalDateTime

string

زمان ورود به فرودگاه محل توقف

بر اساس زمان محلی و با فرمت yyyy-MM-dd HH:mm

DepartureDateTime

string

زمان خروج از فرودگاه محل توقف

بر اساس زمان محلی و با فرمت yyyy-MM-dd HH:mm

Stop2

Complex type

در صورتی که پرواز دارای بیش از یک Stop باشد، اطلاعات مربوط به توقف دوم توسط این فیلد خروجی داده می شود.

ساختار فرمت آن مشابه فیلد Stop1 می باشد.

{
    "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
        }, {
            "FlightNumber": "7777",
            "DepartureDateTime": "2026-05-26 10:00",
            "Origin": "NJF",
            "Destination": "IKA",
            "Aircraft": "AB4",
            "ArrivalDateTime": "2026-05-26 12:00",
            "Duration": 90,
            "Airline": "OV",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "998",
            "DepartureDateTime": "2026-05-26 06:40",
            "Origin": "THR",
            "Destination": "MHD",
            "Aircraft": "146",
            "ArrivalDateTime": "2026-05-26 07:55",
            "Duration": 75,
            "Airline": "W5",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "065",
            "DepartureDateTime": "2026-05-26 09:30",
            "Origin": "THR",
            "Destination": "KIH",
            "Aircraft": "318",
            "ArrivalDateTime": "2026-05-26 11:00",
            "Duration": 90,
            "Airline": "NV",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "512",
            "DepartureDateTime": "2026-05-26 02:30",
            "Origin": "IKA",
            "Destination": "SAW",
            "Aircraft": "M80",
            "ArrivalDateTime": "2026-05-26 05:00",
            "Duration": 180,
            "Airline": "W5",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "4204",
            "DepartureDateTime": "2026-05-26 06:15",
            "Origin": "DXB",
            "Destination": "AZD",
            "Aircraft": "737",
            "ArrivalDateTime": "2026-05-26 08:45",
            "Duration": 180,
            "Airline": "XC",
            "Remarks": "رزرو دوطرفه پرواز چارتري داراي نرخ دوطرفه بدون کميسيون",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "5000",
            "DepartureDateTime": "2026-05-26 09:00",
            "Origin": "KIH",
            "Destination": "DWC",
            "Aircraft": "M80",
            "ArrivalDateTime": "2026-05-26 10:15",
            "Duration": 45,
            "Airline": "Y9",
            "Remarks": "پرواز کيش به فرودگاه آل مکتوم",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "4201",
            "DepartureDateTime": "2026-05-26 06:20",
            "Origin": "THR",
            "Destination": "MHD",
            "Aircraft": "146",
            "ArrivalDateTime": "2026-05-26 07:35",
            "Duration": 75,
            "Airline": "ZV",
            "Remarks": "رزرو دوطرفه پرواز چارتري بدون نرخ دوطرفه بدون کميسيون",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "4213",
            "DepartureDateTime": "2026-05-26 13:00",
            "Origin": "IFN",
            "Destination": "BGW",
            "Aircraft": "146",
            "ArrivalDateTime": "2026-05-26 14:45",
            "Duration": 135,
            "Airline": "IF",
            "Remarks": "رزرو دوطرفه پرواز چارتري داراي نرخ دوطرفه با کميسيون",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "4237",
            "DepartureDateTime": "2026-05-26 10:00",
            "Origin": "MCT",
            "Destination": "BUZ",
            "Aircraft": "AB4",
            "ArrivalDateTime": "2026-05-26 10:30",
            "Duration": 60,
            "Airline": "G9",
            "Remarks": "رزرو روي پروازي که داراي PNR ايرلاين مي‌باشد",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "479",
            "DepartureDateTime": "2026-05-26 12:30",
            "Origin": "THR",
            "Destination": "KIH",
            "Aircraft": "AB4",
            "ArrivalDateTime": "2026-05-26 14:20",
            "Duration": 110,
            "Airline": "IR",
            "Remarks": "پرواز با کابين Premium Economy",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "5001",
            "DepartureDateTime": "2026-05-26 11:45",
            "Origin": "DWC",
            "Destination": "KIH",
            "Aircraft": "M80",
            "ArrivalDateTime": "2026-05-26 12:00",
            "Duration": 45,
            "Airline": "Y9",
            "Remarks": "پرواز فرودگاه آل مکتوم به کيش",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "6000",
            "DepartureDateTime": "2026-05-26 10:40",
            "Origin": "KIH",
            "Destination": "DXB",
            "Aircraft": "M80",
            "ArrivalDateTime": "2026-05-26 11:55",
            "Duration": 45,
            "Airline": "Y9",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "413",
            "DepartureDateTime": "2026-05-26 10:00",
            "Origin": "KIH",
            "Destination": "THR",
            "Aircraft": "AB4",
            "ArrivalDateTime": "2026-05-26 11:10",
            "Duration": 70,
            "Airline": "HH",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "6001",
            "DepartureDateTime": "2026-05-26 11:15",
            "Origin": "DXB",
            "Destination": "KIH",
            "Aircraft": "M80",
            "ArrivalDateTime": "2026-05-26 11:30",
            "Duration": 45,
            "Airline": "Y9",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "8989",
            "DepartureDateTime": "2026-05-26 10:00",
            "Origin": "KIH",
            "Destination": "THR",
            "Aircraft": "310",
            "ArrivalDateTime": "2026-05-26 12:00",
            "Duration": 120,
            "Airline": "VR",
            "Remarks": "",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }, {
            "FlightNumber": "7057",
            "DepartureDateTime": "2027-01-05 12:30",
            "Origin": "AWZ",
            "Destination": "IFN",
            "Aircraft": "AB4",
            "ArrivalDateTime": "2027-01-05 13:25",
            "Duration": 55,
            "Airline": "EP",
            "Remarks": "تست ملاحظات عمومی",
            "Source": "Owned",
            "Stop1": null,
            "Stop2": null
        }
    ]
}