مستندات وب سرویس

متد GetClosedFlights

Download Markdown for LLM

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

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

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


API Endpoint

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

Request Parameters

  • 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


Sample Request

curl -X POST https://SepehrApiTest.ir/api/Partners/Flight/BulkAvailability/V18/GetClosedFlights \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip, deflate" \
  -d '{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "FromDate": "2026-05-26",
    "ToDate": "2027-05-29",
    "FlightSource": "All",
    "Culture": "fa-IR"
}'

Response Parameters

  • ClosedFlightList

    List of ClosedFlight

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

    + نمایش ویژگی‌های زیرمجموعه

    • ClosedFlightList.FlightNumber

      string

      شماره پرواز

    • ClosedFlightList.DepartureDateTime

      string

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

    • ClosedFlightList.Origin

      Complex type

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

    • ClosedFlightList.Destination

      Complex type

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

    • ClosedFlightList.Aircraft

      string

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

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

    • ClosedFlightList.ArrivalDateTime

      string

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

    • ClosedFlightList.Duration

      number

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

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

    • ClosedFlightList.Airline

      string

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

    • ClosedFlightList.Remarks

      string

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

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

    • ClosedFlightList.Source

      string enum

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

      Owned

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

      ThirdParty

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

    • ClosedFlightList.Stop1

      Complex type

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

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

      + نمایش ویژگی‌های زیرمجموعه

      • ClosedFlightList.Stop1.AirportIataCode

        string

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

      • ClosedFlightList.Stop1.FlightDurationUntilThisStopInMinute

        number

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

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

      • ClosedFlightList.Stop1.StopDurationInMinute

        number

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

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

      • ClosedFlightList.Stop1.ArrivalDateTime

        string

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

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

      • ClosedFlightList.Stop1.DepartureDateTime

        string

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

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

    • ClosedFlightList.Stop2

      Complex 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
        }, {
            "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
        }
    ]
}