availability
متد GetActiveRoutes
این متد برای دریافت مسیرهای فعالی که تامین کننده روی آنها دارای پرواز استفاده می گردد.
استفاده از این متد اختیاری می باشد.
کاربرد این متد برای زمانی است که شما قبل از ارسال درخواست SearchByRouteAndDate می خواهید بدانید آیا تامین کننده روی مسیر درخواستی دارای پرواز می باشد یا خیر. و در صورتی که تامین کننده دارای پروازی نبود، درخواست اضافه ارسال نکنید.
در صورتی که شما از متدهای GetRange برای cache کردن اطلاعات availability استفاده می کنید، نیازی به استفاده از این متد وجود ندارد.
پیشنهاد می شود این متد را هر ده دقیقه یک بار فراخوانی نموده و بر اساس نتیجه آن دیتابیس خود را به روز رسانی نمایید.
روش کاری این متد بدین شکل می باشد که اگر روی یک مسیر در طول یک سال آینده، حتی یک روز هفته پرواز وجود داشته باشد (مثلا شنبه) آنگاه آن روز هفته را به عنوان روزی که دارای پرواز است خروجی می دهد. بنابراین در جواب این متد، ممکن است شما با روزهای هفته ای روبرو شوید که این متد به شما گفته است دارای پرواز می باشد ولی وقتی شما درخواست SearchByRouteAndDate برای آن روز و مسیر ارسال می کنید، هیچ پروازی برگشت داده نمی شود. این موضوع مشکل خاصی ایجاد نمی کند و لازم نیست شما در طراحی نرم افزار خود تغییر ایجاد نمایید و این مطلب صرفا جهت اطلاع دقیقتر از روش کاری این متد گفته شد.
API Endpoint
https://{SupplierWebsiteUrl}/api/Partners/Flight/Availability/V17/GetActiveRoutes post
Request Parameters
نمونه کلاس Request به زبان سی شارپ در پروژه Partners.Contracts (دانلود) در پوشه زیر موجود است:
\Flight\Availability\V17\ActiveRoutes\RequestModel
Username
string
نام کاربری
در صورتی که شما یک موتور جستجو هستید و قصد فروش نداشته و فقط می خواهید اطلاعات پروازهای عمومی را بدست آورید، نام کاربری را public ارسال نمایید.
Password
string
رمز عبور به صورت MD5 شده
FetchSupplierWebserviceFlights
boolean
این فیلد مشخص می کند که آیا پروازهایی که تامین کننده از طریق وب سرویس دریافت کرده است و خود چارترکننده آن نیست را وب سرویس خروجی دهد یا خیر.
عموما به دلیل اینکه پروازهای غیرچارتری یک تامین کننده را شما به صورت مستقیم از منبع اصلی آن دریافت می کنید می توانید مقدار false را برای این فیلد ارسال نمایید.
در زمان استفاده از سپهرهاب، مقدار این فیلد باید true ارسال شود.
{
"UserName": "testdev1",
"Password": "25f9e794323b453885f5181f1b624d0b",
"FetchSupplierWebserviceFlights": true
}
Response Data
نمونه کلاس Response به زبان سی شارپ در پروژه Partners.Contracts (دانلود) در پوشه زیر موجود است:
\Flight\Availability\V17\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 خواهد بود.
{
"ActiveRouteList": [
{
"OriginIataCode": "THR",
"DestinationIataCode": "KIH",
"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": "AWZ",
"DestinationIataCode": "IFN",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "IFN",
"DestinationIataCode": "AWZ",
"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": "MHD",
"DestinationIataCode": "THR",
"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": "DXB",
"DestinationIataCode": "AZD",
"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": "IFN",
"DestinationIataCode": "BGW",
"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": "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": "AWZ",
"DestinationIataCode": "PEK",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "PEK",
"DestinationIataCode": "AWZ",
"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": "IKA",
"DestinationIataCode": "IST",
"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": "DXB",
"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": "KIH",
"DestinationIataCode": "DWC",
"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": "IKA",
"DestinationIataCode": "SAW",
"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": "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": "OMH",
"DestinationIataCode": "EVN",
"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": "GBT",
"DestinationIataCode": "DYU",
"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": "TCX",
"DestinationIataCode": "BXR",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "ZAH",
"DestinationIataCode": "KIH",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "KIH",
"DestinationIataCode": "ZAH",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
}
]
}