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

متد Update Flight

Download Markdown for LLM

این متد برای ویرایش و تغییر اطلاعات پایه‌ی یک پرواز موجود در Inventory استفاده می‌گردد.

توجه نمایید درصورتی که بلافاصله پس از ویرایش پرواز با این متد، اقدام به دریافت لیست پروازها با استفاده از متد Get Flight List کنید، ممکن است پرواز را همچنان با اطلاعات قبلی در لیست دریافتی مشاهده کنید. برای جلوگیری از این اتفاق می‌بایست «حداکثر 5 ثانیه» صبر نموده و سپس درخواست Get Flight List را اجرا کنید.


API Endpoint

POST https://{SupplierWebsiteUrl}/api/B2M/Bot/Flight/Charter/FlightManagement/Flight/Update/V1

Request Parameters

  • UserName

    string

    [conditional-required]

    نام کاربری

    در صورت استفاده از روش Username/Password Authentication ارسال این فیلد الزامی است.

  • Password

    string

    [conditional-required]

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

    در صورت استفاده از روش Username/Password Authentication ارسال این فیلد الزامی است.

  • AccessToken

    string

    [conditional-required]

    توکن احراز هویت دریافت‌شده از طریق Single Sign-On (SSO).

    در صورت استفاده از روش Token-based Authentication این فیلد را ارسال کنید. در این حالت نیازی به ارسال UserName و Password نیست.

    برای آشنایی با روش‌های احراز هویت و نحوه انتخاب و استفاده از هر روش، به مستندات Authentication مراجعه کنید.

  • FlightId

    number

    required

    شناسه منحصر به فرد پرواز

  • OldData

    object

    required

    اطلاعات قبلی پرواز. مقادیر فیلدهای این شی باید دقیقا مطابق با اطلاعات پرواز در قبل از ویرایش پرواز باشد

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

    • OldData.FlightNumber

      string

      required

      شماره پرواز

    • OldData.FlightDate

      string

      required

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

    • OldData.OriginIataCode

      string

      required

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

    • OldData.DestinationIataCode

      string

      required

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

    • OldData.AirlineIataCode

      string

      required

      کد یاتای شرکت هواپیمایی

    • OldData.SeatCapacity

      number

      required

      تعداد ظرفیت کلی پرواز

    • OldData.HideFlightFromSubsidiaryAgencies

      bool

      required

      مخفی کردن پرواز از دید کاربران خارج از دفتر مرکزی

    • OldData.AircraftId

      number

      required

      شناسه منحصر به فرد هواپیما

    • OldData.FlightDurationInMinute

      number

      required

      طول کلی پرواز از زمان خروج تا ورود به مقصد

    • OldData.PublicRemarks

      string

      required

      ملاحظات عمومی که روی پرواز نوشته می‌شود و قابل مشاهده در صفحه رزرو پرواز می‌باشد

    • OldData.PrivateRemarks

      string

      required

      ملاحظات خصوصی که روی پرواز نوشته شده است و فقط توسط کاربران دفترمرکزی قابل مشاهده می‌باشد

    • OldData.ETicketRemarks

      string

      required

      ملاحظات عمومی که جهت نمایش روی بلیت نوشته می‌شود. این ملاحظات روی فایل بلیت به رنگ قرمز نمایش داده می‌شود

    • OldData.CanIssueOpenReturning

      bool

      required

      ایجاد امکان رزرو همزمان پرواز برگشت بصورت OPEN با این پرواز

    • OldData.PreventBookReturningFlightOnOtherAirlines

      bool

      required

      جلوگیری از امکان رزرو همزمان پرواز برگشت روی ایرلاینی متفاوت با ایرلاین این پرواز

    • OldData.CloseTimeoutInMinute

      number

      required

      تعیین میکند که چند دقیقه قبل از ساعت خروج، پرواز به صورت خودکار close شود. مقدار 0 به معنای عدم close شدن خودکار می‌باشد

    • OldData.StatusId

      number

      required

      شناسه وضعیت پرواز. مقادیر مجاز: 1 ، 2 ، 3 ، 4 ، 5 که به ترتیب عبارتند از: Boarding ، Checkin ، Closed ، Canceled ، OnTime

  • NewData

    object

    required

    اطلاعات جدید پرواز

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

    • NewData.FlightNumber

      string

      required

      شماره پرواز

    • NewData.FlightDate

      string

      required

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

    • NewData.OriginIataCode

      string

      required

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

    • NewData.DestinationIataCode

      string

      required

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

    • NewData.AirlineIataCode

      string

      required

      کد یاتای شرکت هواپیمایی

    • NewData.SeatCapacity

      number

      required

      تعداد ظرفیت کلی پرواز

    • NewData.HideFlightFromSubsidiaryAgencies

      bool

      required

      مخفی کردن پرواز از دید کاربران خارج از دفتر مرکزی

    • NewData.AircraftId

      number

      required

      شناسه منحصر به فرد هواپیما

    • NewData.FlightDurationInMinute

      number

      required

      طول کلی پرواز از زمان خروج تا ورود به مقصد

    • NewData.PublicRemarks

      string

      optional

      ملاحظات عمومی که روی پرواز نوشته می‌شود و قابل مشاهده در صفحه رزرو پرواز می‌باشد

    • NewData.PrivateRemarks

      string

      optional

      ملاحظات خصوصی که روی پرواز نوشته شده است و فقط توسط کاربران دفترمرکزی قابل مشاهده می‌باشد

    • NewData.ETicketRemarks

      string

      optional

      ملاحظات عمومی که جهت نمایش روی بلیت نوشته می‌شود. این ملاحظات روی فایل بلیت به رنگ قرمز نمایش داده می‌شود

    • NewData.CanIssueOpenReturning

      bool

      required

      ایجاد امکان رزرو همزمان پرواز برگشت بصورت OPEN با این پرواز

    • NewData.PreventBookReturningFlightOnOtherAirlines

      bool

      required

      جلوگیری از امکان رزرو همزمان پرواز برگشت روی ایرلاینی متفاوت با ایرلاین این پرواز

    • NewData.CloseTimeoutInMinute

      number

      required

      تعیین میکند که چند دقیقه قبل از ساعت خروج، پرواز به صورت خودکار close شود. مقدار 0 به معنای عدم close شدن خودکار می‌باشد

    • NewData.StatusId

      number

      required

      شناسه وضعیت پرواز. مقادیر مجاز: 1 ، 2 ، 3 ، 4 ، 5 که به ترتیب عبارتند از: Boarding ، Checkin ، Closed ، Canceled ، OnTime


Sample Request

curl -X POST https://SepehrApiTest.ir/api/B2M/Bot/Flight/Charter/FlightManagement/Flight/Update/V1 \
  -H "Content-Type: application/json; charset=utf-8" \
  -H "Accept: application/json" \
  -H "Accept-Encoding: gzip, deflate" \
  -d '{
    "UserName": "sample-head-office-user",
    "Password": "25f9e794323b453885f5181f1b624d0b",
    "FlightId": 65420,
    "OldData": {
        "FlightNumber": "7410",
        "FlightDate": "2025-08-20 13:30",
        "OriginIataCode": "IFN",
        "DestinationIataCode": "AWZ",
        "AirlineIataCode": "FP",
        "SeatCapacity": 100,
        "HideFlightFromSubsidiaryAgencies": false,
        "AircraftId": 1,
        "FlightDurationInMinute": 105,
        "PublicRemarks": "",
        "PrivateRemarks": "",
        "ETicketRemarks": "",
        "CanIssueOpenReturning": false,
        "PreventBookReturningFlightOnOtherAirlines": false,
        "CloseTimeoutInMinute": 0,
        "StatusId": 1
    },
    "NewData": {
        "FlightNumber": "7410",
        "FlightDate": "2025-08-20 13:30",
        "OriginIataCode": "IFN",
        "DestinationIataCode": "AWZ",
        "AirlineIataCode": "FP",
        "SeatCapacity": 110,
        "HideFlightFromSubsidiaryAgencies": false,
        "AircraftId": 1,
        "FlightDurationInMinute": 105,
        "PublicRemarks": "",
        "PrivateRemarks": "",
        "ETicketRemarks": "",
        "CanIssueOpenReturning": false,
        "PreventBookReturningFlightOnOtherAirlines": false,
        "CloseTimeoutInMinute": 0,
        "StatusId": 1
    }
}'

Response Parameters

  • No Content

    http code 204

    ریسپانس فاقد بدنه می‌باشد


Sample Response

204 No Content