availability
متد GetActiveRoutes
این متد برای دریافت مسیرهای فعالی که تامین کننده روی آنها دارای پرواز استفاده می گردد.
استفاده از این متد اختیاری می باشد.
کاربرد این متد برای زمانی است که شما قبل از ارسال درخواست SearchByRouteAndDate می خواهید بدانید آیا تامین کننده روی مسیر درخواستی دارای پرواز می باشد یا خیر. و در صورتی که تامین کننده دارای پروازی نبود، درخواست اضافه ارسال نکنید.
در صورتی که شما از متدهای GetRange برای cache کردن اطلاعات availability استفاده می کنید، نیازی به استفاده از این متد وجود ندارد.
پیشنهاد می شود این متد را هر ده دقیقه یک بار فراخوانی نموده و بر اساس نتیجه آن دیتابیس خود را به روز رسانی نمایید.
روش کاری این متد بدین شکل می باشد که اگر روی یک مسیر در طول یک سال آینده، حتی یک روز هفته پرواز وجود داشته باشد (مثلا شنبه) آنگاه آن روز هفته را به عنوان روزی که دارای پرواز است خروجی می دهد. بنابراین در جواب این متد، ممکن است شما با روزهای هفته ای روبرو شوید که این متد به شما گفته است دارای پرواز می باشد ولی وقتی شما درخواست SearchByRouteAndDate برای آن روز و مسیر ارسال می کنید، هیچ پروازی برگشت داده نمی شود. این موضوع مشکل خاصی ایجاد نمی کند و لازم نیست شما در طراحی نرم افزار خود تغییر ایجاد نمایید و این مطلب صرفا جهت اطلاع دقیقتر از روش کاری این متد گفته شد.
API Endpoint
POST https://{SupplierWebsiteUrl}/api/Partners/Flight/Availability/V18/GetActiveRoutes
Request Parameters
Usernamestring
required
نام کاربری
در صورتی که شما یک موتور جستجو هستید و قصد فروش نداشته و فقط می خواهید اطلاعات پروازهای عمومی را بدست آورید، نام کاربری را public ارسال نمایید.
Passwordstring
required
رمز عبور به صورت MD5 شده
FlightSourcestring enum
required
این فیلد تعیین میکند که درخواست شما چه نوع پروازهایی را برگرداند. مقدار این فیلد میتواند یکی از گزینههای زیر باشد:
All
تمامی پروازهای موجود (چه متعلق به تأمینکننده مورد درخواست و چه دریافتشده از سایر تأمینکنندگان).
OwnedFlight
فقط پروازهایی که تأمینکنندهای که به آن درخواست ارسال کردهاید مالک نرخ و ظرفیت آنهاست.
ThirdPartyFlight
فقط پروازهایی که تأمینکننده مورد درخواست، مالک نرخ و ظرفیت آنها نیست و آنها را از طریق وبسرویس از تأمینکننده دیگری دریافت کرده است (پروازهای وب سرویسی یا واسطهای).
در زمان استفاده از سپهرهاب، مقدار این فیلد باید All یا ThirdPartyFlight ارسال شود.
Culturestring enum
required
مشخصکننده زبان متنهای بازگشتی در پاسخ سرویس. مقادیر پذیرفته شده عبارتند از: fa-IR ، en-US و ar-IQ
Sample Request
curl -X POST https://SepehrApiTest.ir/api/Partners/Flight/Availability/V18/GetActiveRoutes \
-H "Content-Type: application/json; charset=utf-8" \
-H "Accept: application/json" \
-H "Accept-Encoding: gzip, deflate" \
-d '{
"UserName": "testdev1",
"Password": "25f9e794323b453885f5181f1b624d0b",
"FlightSource": "All",
"Culture": "fa-IR"
}'
Response Parameters
ActiveRouteListList of ActiveRoute
لیست مسیرهایی که تامین کننده روی آن مسیرها دارای پرواز با سهمیه اختصاصی (چارتر) می باشد.
ActiveRouteList.OriginIataCodestring
کد یاتا سه حرفی فرودگاه مبدا مسیر
ActiveRouteList.DestinationIataCodestring
کد یاتا سه حرفی فرودگاه مقصد مسیر
ActiveRouteList.Saturdayboolean
در صورتی که روی مسیر در روزهای شنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.
ActiveRouteList.Sundayboolean
در صورتی که روی مسیر در روزهای یکشنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.
ActiveRouteList.Mondayboolean
در صورتی که روی مسیر در روزهای دوشنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.
ActiveRouteList.Tuesdayboolean
در صورتی که روی مسیر در روزهای سه شنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.
ActiveRouteList.Wednesdayboolean
در صورتی که روی مسیر در روزهای چهارشنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.
ActiveRouteList.Thursdayboolean
در صورتی که روی مسیر در روزهای پنج شنبه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.
ActiveRouteList.Fridayboolean
در صورتی که روی مسیر در روزهای جمعه پروازی وجود داشته باشد، مقدار این فیلد true و در غیر این صورت false خواهد بود.
Sample Response
{
"ActiveRouteList": [
{
"OriginIataCode": "IKA",
"DestinationIataCode": "IST",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "IKA",
"DestinationIataCode": "ADB",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "BSR",
"DestinationIataCode": "NJF",
"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": "IFN",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "AWZ",
"DestinationIataCode": "KIH",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "KIH",
"DestinationIataCode": "AWZ",
"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": "THR",
"DestinationIataCode": "GSM",
"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": "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": "IKA",
"DestinationIataCode": "NJF",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "ABD",
"DestinationIataCode": "AWZ",
"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": "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
},
{
"OriginIataCode": "AWZ",
"DestinationIataCode": "ABD",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "THR",
"DestinationIataCode": "NJF",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "NJF",
"DestinationIataCode": "THR",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
},
{
"OriginIataCode": "PYK",
"DestinationIataCode": "NJF",
"Saturday": true,
"Sunday": true,
"Monday": true,
"Tuesday": true,
"Wednesday": true,
"Thursday": true,
"Friday": true
}
]
}