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

متد Create 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/Create/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 مراجعه کنید.

  • FlightNumber

    string

    required

    شماره پرواز

  • FlightDate

    string

    required

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

  • OriginIataCode

    string

    required

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

  • DestinationIataCode

    string

    required

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

  • AirlineIataCode

    string

    required

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

  • SeatCapacity

    number

    required

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

  • HideFlightFromSubsidiaryAgencies

    bool

    required

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

  • AircraftId

    number

    required

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

  • FlightDurationInMinute

    number

    required

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

  • PublicRemarks

    string

    optional

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

  • ETicketRemarks

    string

    optional

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

  • CanIssueOpenReturning

    bool

    required

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

  • PreventBookReturningFlightOnOtherAirlines

    bool

    required

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

  • CloseTimeoutInMinute

    number

    required

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


Sample Request

curl -X POST https://SepehrApiTest.ir/api/B2M/Bot/Flight/Charter/FlightManagement/Flight/Create/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",
    "FlightNumber": "7057",
    "FlightDate": "2025-01-05 12:30",
    "OriginIataCode": "AWZ",
    "DestinationIataCode": "IFN",
    "AirlineIataCode": "EP",
    "SeatCapacity": 80,
    "HideFlightFromSubsidiaryAgencies": false,
    "AircraftId": 1,
    "FlightDurationInMinute": 55,
    "PublicRemarks": "تست ملاحظات عمومی",
    "ETicketRemarks": "تست ملاحظات بلیت",
    "CanIssueOpenReturning": false,
    "PreventBookReturningFlightOnOtherAirlines": false,
    "CloseTimeoutInMinute": 240
}'

Response Parameters

  • flightId

    number

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


Sample Response

{
    "flightId": 71542
}