flight-management

متد Create Flight

این متد برای ایجاد پرواز جدید در 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": "testdev1",
    "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