مسافران Changed Schedule

متد Webservice Segments

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

پیشنهاد می کنیم این متد را در دوره های زمانی متناوب (مثلا هر 15 دقیقه یکبار) فراخوانی نموده و رزروهایی که تغییرات داشته اند را به اطلاع مسافران خود برسانید.

این متد صرفا رزروهایی که سگمنت پروازی آنها سهمیه خود تامین کننده نبوده است (اصطلاحا سهمیه وب سرویس بوده باشد) را بر میگرداند. جهت دریافت رزروهای که تامین کننده سهمیه گارانتی و چارتر خودش بوده است از متد Charter استفاده نمایید.

API Endpoint
https://{SupplierWebsiteUrl}/api/Partners/ChangedSchedulePassengers/V1/Webservice/Get post
Request Parameters

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

\Flight\ChangedSchedulePassengers\V1\Webservice\Get\RequestModel

Username

string

required

نام کاربری

Password

string

required

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

RecordId

number

required

RecordId مربوط به آخرین Booking در فراخوانی قبلی بدست آورده اید. سیستم 500 عدد رکورد بعد از این عدد را خروجی خواهد داد.

در صورتی که اولین بار است این متد را فراخوانی می نمایید، می توانید عدد 0 را ارسال نمایید.

Sample Request 
{
  "Username": "testdev1",
  "Password": "25f9e794323b453885f5181f1b624d0b",
  "RecordId": 0
}
Response Data

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

\Flight\ChangedSchedulePassengers\V1\Webservice\Get\ResponseModel

BookingList

List(Booking)

لیست رزرو های که پرواز مسافران آن تغییر برنامه داده شده است

RecordId

integer

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

Pnr

string

رفرنس رزرو

BookingDateTime

string

زمان انجام شدن رزرو

فرمت این فیلد yyyy-MM-dd HH:mm:ss می باشد

تاریخ میلادی و به ناحیه زمانی UTC می باشد

ChangeScheduleDateTime

string

زمان انجام شدن تغییرات

فرمت این فیلد yyyy-MM-dd HH:mm:ss می باشد

تاریخ میلادی و به ناحیه زمانی UTC می باشد

YourLocalInventoryPnr

string

رفرنس سیستم داخلی شما

PassengerList

List(Passenger)

لیست مسافران

AgeType

string

گروه سنی مسافر که شامل یکی از مقادیر ADL یا CHD یا INF می باشد

FirstName

string

نام مسافر

LastName

string

نام خانوادگی مسافر

Gender

string

تست توضیحات

جنسیت مسافر که یکی از مقادیر M یا F را دارد.

TicketNumber

string

شماره بلیط

OldFlightSegment

complex type

اطلاعات سگنمت پرواز قبل از اعمال شدن تغییرات

FlightNumber

string

شماره پرواز

FlightDate

string

تاریخ پرواز

فرمت این فیلد yyyy-MM-dd HH:mm می باشد

تاریخ میلادی و به ناحیه زمانی محلی مبدا پرواز می باشد

AirlineIataCode

string

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

OriginIataCode

string

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

DestinationIataCode

string

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

NewFlightSegment

complex type

اطلاعات سگمنت پرواز بعد از اعمال شدن تغییرات

ساختار آن کاملا مشابه OldFlightSegment می باشد

Sample Response 
{
  "BookingList": [
    {
      "RecordId": 4,
      "Pnr": "XG8255",
      "BookingDateTime": "2023-11-14 06:54:50",
      "ChangeScheduleDateTime": "2023-11-15 06:04:46",
      "YourLocalInventoryPnr": null,
      "PassengerList": [
        {
          "AgeType": "ADL",
          "FirstName": "AKBAR",
          "LastName": "KABIRI",
          "Gender": "M",
          "TicketNumber": "1002046",
          "OldFlightSegment": {
            "FlightNumber": "888",
            "FlightDate": "2023-11-15 19:00",
            "AirlineIataCode": "J1",
            "OriginIataCode": "NJF",
            "DestinationIataCode": "IKA"
          },
          "NewFlightSegment": {
            "FlightNumber": "7888",
            "FlightDate": "2023-11-15 19:00",
            "AirlineIataCode": "J1",
            "OriginIataCode": "IKA",
            "DestinationIataCode": "NJF"
          }
        }
      ]
    }
  ]
}
Response common exceptions

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

ExceptionType توضیح خطا

Exception

خطای نامشخص. جهت دریافت اطلاعات بیشتر باید به ErrorMessage داخل json برگشتی مراجعه نمود.