پیش نیازها و شرایط اخذ API چارتری

داشتن مجوز بند (الف) از سازمان هواپیمایی کشوری #

آژانس های بند الف تحت نظارت مستقیم سازمان هواپیمایی کشوری هستند و وظیفه اصلی آنها فروش بلیط خطوط هوایی داخلی و خارجی است. آژانس های بند الف به هیچ عنوان حق برگزاری تور را ندارند. همچنین مجوز فروش تورهای سایر دفاتر برگزار کننده را نداشته و مجاز به عقد قرارداد تور با مسافر نیستند.

داشتن سرویس با قابلیت هاب ایرپلاس #

یکی دیگر از پیش نیاز های اتصای به سرویس چارتری داشتن سرویس  با قابلیت هاب ایرپلاس از مجموعه می باشد. این سرویس پس از گذراندن مراحل مختلف اخذ و پس از آن میتوانید از طریق پنل درخواست ارتباط خود را ارسال فرمائید.

تعاریف و اصطلاحات استفاده شده در مستندات #

لطفا در هنگام استفاده از مستندات، تعاریف زیر را مد نظر داشته باشید:

تامین کننده: منظور آژانس مسافرتی و یا سرویس  است که شما در حال استفاده از API آن می باشید.

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

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

متد: منظور webapi یا تابعی هست که شما با استفاده از یک Url و روی بستر Https آن را فراخوانی می کنید.

کلاینت: یا Client به شخصی که از متدهای وب سرویس استفاده می کند اشاره دارد. معمولا منظور شخص خواننده – شما – هستید.

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

آژانس آنلاین: یا OTA به کلاینتی گفته می شود که به مسافر فروش بلیط انجام می دهد.

نکات کلی و ابتدایی راه اندازی سرویس #

1. پیش نیاز کار با این سرویس داشتن دانش فنی مانند (Rest-full API, JWT Authentication) و آشناییت کامل با عملیات های چارتری و رزرو بلیت، هتل و خدمات.
2. جهت استفاده از سرویس ایرپلاس، نیاز است که IP شما در هسته مرکزی Trust گردد. Trust کردن تا 2 عدد IP به صورت رایگان انجام می پذیرد. اما لطفا در نظر داشته باشید فرایند اداری و فنی اینکار ممکن است تا 1 روز کاری زمان ببرد.
3. در سیستم ایرپلاس، تامین کننده می تواند برای هر کاربر (کلاینت) نرخ و ظرفیتی اختصاصی را تعریف نماید. بنابراین لطفا حتما دقت فرمایید که با همان کاربری که بعدا می خواهید رزرو انجام دهید درخواست های Availability خود را ارسال نمایید. در غیر این صورت و هنگام متفاوت بودن نرخ یا ظرفیت، رزرو شما به خطا برخورد خواهد کرد.
4. هیچ کدام از اسم متدها، یا پارامترهای ارسالی به آنها، Case Sensitive نیست و بزرگ یا کوچک بودن حروف هنگام کار با آنها، تاثیری در نتیجه ندارد.
5. برای تست می توانید از بخش پشتیبانی درخواست سرویس دمو فرمائید و پس از آن به عنوان تامین کننده استفاده نمایید. همچنین اطلاعات پروازها و مسیرهایی که می توان روی آنها رزرو تستی انجام داد در صفحه کار با سرویس دمو موجود می باشد.
6. در حالت هایی ممکن است DNS های سایت یک تامین کننده بدون اطلاع قبلی تغییر پیدا کند. و اگر شما در زمان توسعه نرم افزار خود از یک object به صورت singleton برای مدیریت درخواست های http خود استفاده کرده باشید، ممکن است متوجه تغییرات DNS نشده و درخواست های شما با خطا روبرو شود. بنابراین در زمان توسعه نرم افزار خود این مورد را در نظر داشته باشید.

Header های اجباری برای تمامی درخواست ها #

لطفا دقت نموده که به همراه تمامی درخواست های خود، header های زیر را نیز ارسال نمایید.

//(required) - 1
Content-Type: application/json; charset=utf-8
//(required) - 2
Accept: application/json
//(required) - 3
Accept-Encoding: gzip, deflate

1. استفاده از این Header مشخص می کند که فرمت درخواست شما json بوده و encoding که برای ارسال اطلاعات استفاده شده utf-8 می باشد.
2. استفاده از این Header به هسته مرکزی اعلام می کند که باید جواب را به صورت json برگشت دهد.
3. استفاده از این Header باعث می گردد جواب برگشتی از سرور به صورت فشرده شده باشد.

استفاده از Https و TLS #

تمام در خواست های ارسالی به هسته مرکزی الزاما باید از بستر HTTPS استفاده نمایند. و درخواست های بدون SSL و روی بستر HTTP را پشتیبانی نمی شود.

همچنین زمان ارسال درخواست حتما از Tls ورژن 1.2 استفاده کنید. اینکار در .Net به صورت زیر انجام می شود:

System.Net.ServicePointManager.SecurityProtocol = System.Net.SecurityProtocolType.Tls12;

در صورتی که از پلتفرمی غیر از .Net برای توسعه نرم افزار خود استفاده می کنید، جهت استفاده از Tls 1.2 به مستندات پلتفرم مربوطه مراجعه کنید.

نحوه ی تراست کردن IP #

جهت استفاده از وب سرویس باید IP شما در اتوماسیون Trust شود. از آنجایی که در سیستم تراست کردن IP بر اساس کاربر و روی هر سایت تامین کننده به صورت جداگانه انجام می شود، جهت تراست کردن IP باید از طریق پنل کاربری خود نسبت به ارسال درخواست در قسمت پشتیبانی اقدام فرمائید.

متدهای قابل پشتیبانی #

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

ورژن بندی سرویس #

در حال حاضر طبق جدول ذیل ورژن 1 سرویس در حال اجرا می باشد.

این ورژن از پایداری بسیار بالایی برخوردار است. همچنین کلیه موارد امنیتی در این نسخه بصورت کامل رعایت شده است.

قابل توجه است در صورت تغییر ورژن از قبل اطلاع رسانی خواهد شد و مدت زمان معینی جهت مهاجرت به ورژن جدید اختصاص داده خواهد شد و پس از آن ورژن قبلی به فعالیت خود خاتمه خواهد داد.