GetActiveRoutes – Sepehr Integration Docs

availability

متد GetActiveRoutes

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

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

کاربرد این متد برای زمانی است که شما قبل از ارسال درخواست SearchByRouteAndDate می خواهید بدانید آیا تامین کننده روی مسیر درخواستی دارای پرواز می باشد یا خیر. و در صورتی که تامین کننده دارای پروازی نبود، درخواست اضافه ارسال نکنید.

در صورتی که شما از متدهای GetRange برای cache کردن اطلاعات availability استفاده می کنید، نیازی به استفاده از این متد وجود ندارد.

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

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

API Endpoint

https://{SupplierWebsiteUrl}/api/Partners/Flight/Availability/V18/GetActiveRoutes post

Request Parameters

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

\Flight\Availability\V18\ActiveRoutes\RequestModel

Username

string

required

نام کاربری

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

Password

string

required

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

FlightSource

string enum

required

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

All

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

OwnedFlight

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

ThirdPartyFlight

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

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

Culture

string enum

required

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

{
    "UserName": "testdev1",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "FlightSource": "All",
    "Culture": "fa-IR"
}

Response Data

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

\Flight\Availability\V18\ActiveRoutes\ResponseModel

ActiveRouteList

List of ActiveRoute

لیست مسیرهایی که تامین کننده روی آن مسیرها دارای پرواز با سهمیه اختصاصی (چارتر) می باشد.

OriginIataCode

string

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

DestinationIataCode

string

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

Saturday

boolean

در صورتی که روی مسیر در روزهای شنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.

Sunday

boolean

در صورتی که روی مسیر در روزهای یکشنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.

Monday

boolean

در صورتی که روی مسیر در روزهای دوشنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.

Tuesday

boolean

در صورتی که روی مسیر در روزهای سه شنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.

Wednesday

boolean

در صورتی که روی مسیر در روزهای چهارشنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.

Thursday

boolean

در صورتی که روی مسیر در روزهای پنج شنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.

Friday

boolean

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

[{
        "OriginIataCode": "MHD",
        "DestinationIataCode": "THR",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "SAW",
        "DestinationIataCode": "IKA",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "NJF",
        "DestinationIataCode": "IKA",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "THR",
        "DestinationIataCode": "MHD",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "IST",
        "DestinationIataCode": "IKA",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "TBZ",
        "DestinationIataCode": "SYZ",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "SYZ",
        "DestinationIataCode": "TBZ",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "THR",
        "DestinationIataCode": "KIH",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "IKA",
        "DestinationIataCode": "SAW",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "DXB",
        "DestinationIataCode": "AZD",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "AZD",
        "DestinationIataCode": "DXB",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "KIH",
        "DestinationIataCode": "DWC",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "BGW",
        "DestinationIataCode": "IFN",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "IFN",
        "DestinationIataCode": "BGW",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "KIH",
        "DestinationIataCode": "SRY",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "SRY",
        "DestinationIataCode": "KIH",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "KER",
        "DestinationIataCode": "AYT",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "AYT",
        "DestinationIataCode": "KER",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "MCT",
        "DestinationIataCode": "BUZ",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "DWC",
        "DestinationIataCode": "KIH",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "KIH",
        "DestinationIataCode": "DXB",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "IKA",
        "DestinationIataCode": "IST",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "IKA",
        "DestinationIataCode": "DXB",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "DXB",
        "DestinationIataCode": "IKA",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "KIH",
        "DestinationIataCode": "THR",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "DXB",
        "DestinationIataCode": "KIH",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "IKA",
        "DestinationIataCode": "NJF",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "AWZ",
        "DestinationIataCode": "IFN",
        "Saturday": false,
        "Sunday": false,
        "Monday": false,
        "Tuesday": true,
        "Wednesday": false,
        "Thursday": false,
        "Friday": false
    }, {
        "OriginIataCode": "GSM",
        "DestinationIataCode": "MCT",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "MCT",
        "DestinationIataCode": "GSM",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "BND",
        "DestinationIataCode": "ADB",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "ADB",
        "DestinationIataCode": "BND",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "EVN",
        "DestinationIataCode": "OMH",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "OMH",
        "DestinationIataCode": "EVN",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "TCX",
        "DestinationIataCode": "BXR",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "DYU",
        "DestinationIataCode": "GBT",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }, {
        "OriginIataCode": "GBT",
        "DestinationIataCode": "DYU",
        "Saturday": true,
        "Sunday": true,
        "Monday": true,
        "Tuesday": true,
        "Wednesday": true,
        "Thursday": true,
        "Friday": true
    }
]
}