Advanced Search
Search Results
127 total results found
Web Service API
مستندات API ایرپلاس با هدف سادهسازی فرایند پیادهسازی برای همکاران ایجاد شده است. API یا رابط برنامهنویسی کاربردی (Application Programming Interface) مانند منوی یک رستوران عمل میکند؛ فهرستی از قابلیتها را در اختیار توسعهدهندگان قرار میدهد، بدون آنکه نیا...
Socket Service
Docker Service
Database
قبل از شروع!
Back-end1
ارتباط و احراز هویت
جستجو و نمایش
قفل، خرید و بررسی
استرداد و تغییر
مالی
پیش نیازها و شرایط اخذ API چارتری
مدیریت خطاها – Error handling
دریافت لیست خطا ها و راه حل ها – Get Errors
در این بخش شما میتوانید لیست error code هایی که در api های مختلف ممکن است آنها با مواجه شوید را دریافت نمایید و راه حل های هر ارور را میتوانید مشاهده نمایید.
احرازهویت و ارتباط با سرویس
جستجو چارترهای موجود (باامکان افزودن بازه زمانی) – Search
شما به دو روش کلی و متفاوت می توانید اطلاعات availability را دریافت نمایید. روش اول: درخواست real-timeدر این روش، هربار که مسافری در سایت شما جستجو انجام دهد، شما با ارسال درخواست اطلاعات availability را دریافت کرده و به مسافر نمایش می دهید.این روش مناسب زمان...
بررسی آیتم جستجو شده قبل از خرید – Item Status
هنگام خرید چارتر ممکن است کمی زمان برای وارد کردن اطلاعات مسافر نیاز باشد به همین دلیل امکان تغییر قیمت چارتر یا بقیه مشخصات وجود دارد. در این بخش قبل از انتقال کاربر به درگاه پرداخت قیمت و تعداد باقیمانده و بقیه مشخصات چارتر مجدد مورد برسی قرار میگیرد تا از ...
مدیریت خطاها – Error handling
گرفتن IP آدرس هاست و ارتباطی – Get IP
ساخت لینک – Deep Link (بزودی)
خرید آیتم جستجو شده – Book
این API بهطور اختصاصی برای انجام عملیات رزرو چارتری طراحی شده است. از طریق این API تنها میتوانید درخواستهای رزرو جدید برای چارتری ارسال کنید و اطلاعات مربوط به رزرو انجام شده را دریافت نمایید.
آخرین وضعیت آیتم خریداری شده – Book Status
در این بخش میتوانید از وضعیت رزرو خود مطلع شوید.
قفل آیتم جستجو شده – Lock
در این بخش شما میتوانید آیتم جستجو شده ی خود را جهت رزرو قفل کنید.
لغو قفل انجام شده – Unlock
در این بخش شما میتوانید قفل یک رزرو را که قبلا با استفاده از api lock انجام داده اید لغو کنید.
لیست خریدها – Book History (بزودی)
رویه استرداد آیتم خریداری شده – Refund Procedure
در این بخش شما میتوانید رویه استرداد آیتم خریداری شده و مقدار جریمه ی استرداد آیتم مورد نظر را دریافت نمایید.
استرداد آیتم خریداری شده – Refund
در این بخش میتوانید آیتم خریداری شده استرداد نمایید.
رویه تغییر آیتم های خریداری شده – Change Procedure (بزودی)
تغییر آیتم های خریداری شده – Change (بزودی)
گزارشات مالی – Financial History (بزودی)
دریافت میزان اعتبار – Credit (بزودی)
داشتن مجوز بند (الف) از سازمان هواپیمایی کشوری
آژانس های بند الف تحت نظارت مستقیم سازمان هواپیمایی کشوری هستند و وظیفه اصلی آنها فروش بلیط خطوط هوایی داخلی و خارجی است. آژانس های بند الف به هیچ عنوان حق برگزاری تور را ندارند. همچنین مجوز فروش تورهای سایر دفاتر برگزار کننده را نداشته و مجاز به عقد قرارداد ت...
داشتن سرویس با قابلیت هاب ایرپلاس
یکی دیگر از پیش نیاز های اتصای به سرویس چارتری داشتن سرویس با قابلیت هاب ایرپلاس از مجموعه می باشد. این سرویس پس از گذراندن مراحل مختلف اخذ و پس از آن میتوانید از طریق پنل درخواست ارتباط خود را ارسال فرمائید.
تعاریف و اصطلاحات استفاده شده در مستندات
لطفا در هنگام استفاده از مستندات، تعاریف زیر را مد نظر داشته باشید: تامین کننده: منظور آژانس مسافرتی و یا سرویس است که شما در حال استفاده از API آن می باشید. پروازهای چارتری: به پروازهایی گفته می شود که تامین کننده مالک سهمیه و نرخ آن پرواز می باشد. پروازه...
نکات کلی و ابتدایی راه اندازی سرویس
پیش نیاز کار با این سرویس داشتن دانش فنی مانند (Rest-full API, JWT Authentication) و آشناییت کامل با عملیات های چارتری و رزرو بلیت، هتل و خدمات. جهت استفاده از سرویس ایرپلاس، نیاز است که IP شما در هسته مرکزی Trust گردد. Trust کردن تا 2 عدد IP به صورت رایگان...
Header های اجباری برای تمامی درخواست ها
لطفا دقت نموده که به همراه تمامی درخواست های خود، header های زیر را نیز ارسال نمای HTTP //(required) - 1 Content-Type: application/json; charset=utf-8 //(required) - 2 Accept: application/json //(required) - 3 Accept-Encoding: gzip, deflate استفا...
استفاده از Https و TLS
تمام در خواست های ارسالی به هسته مرکزی الزاما باید از بستر HTTPS استفاده نمایند. و درخواست های بدون SSL و روی بستر HTTP را پشتیبانی نمی شود. همچنین زمان ارسال درخواست حتما از Tls ورژن 1.2 استفاده کنید. اینکار در .Net به صورت زیر انجام می شود: System.Net.Serv...
نحوه ی تراست کردن IP
جهت استفاده از وب سرویس باید IP شما در اتوماسیون Trust شود. از آنجایی که در سیستم تراست کردن IP بر اساس کاربر و روی هر سایت تامین کننده به صورت جداگانه انجام می شود، جهت تراست کردن IP باید از طریق پنل کاربری خود نسبت به ارسال درخواست در قسمت پشتیبانی اقدام فرم...
متدهای قابل پشتیبانی
سرویس فعلی از متدهای زیر پشتیبانی می کند نام متد کاربرد توضیحات GET دریافت اطلاعات از ارسال اطلاعات محرمانه در این متد خودداری فرمائید POST ایجاد اطلاعات این متد مرسوم ترین روش ارسال داده می باشد PATCH ویرایش جزئی اطلاعات در ویر...
ورژن بندی سرویس
در حال حاضر طبق جدول ذیل ورژن 1 سرویس در حال اجرا می باشد. این ورژن از پایداری بسیار بالایی برخوردار است. همچنین کلیه موارد امنیتی در این نسخه بصورت کامل رعایت شده است. قابل توجه است در صورت تغییر ورژن از قبل اطلاع رسانی خواهد شد و مدت زمان معینی جهت مهاجرت ...
مقدمه ای بر Error Handling
قبل از هر چیز لازم است بدانیم مدیریت خطا یا error handling به چه معناست. این اصطلاح به واکنش و مکانیسمهای بازیابی نرمافزار در صورت بروز خطا اشاره میکند. به عبارت دیگر این کار فرآیندی است که شامل پیشبینی دقیق، شناسایی و رفع خطاها در برنامهها است. اجرای من...
نحوه نگارش خطاها
پاسخ نادرست – Response False یا همان مشکل در ارسال اطلاعات عنوان نوع مقادیر توضیحات status Boolean false مقدار در پاسخ نادرست همیشه false است time Timestamp زمان تولید پاسخ این زمان بر اساس timestamp می باشد – در صورت نیاز از ای...
Status Code – کدهای وضعیتی درخواست ها
وضعیت 200 — OK کد وضعیت 200 OK نشان میدهد که درخواست بهدرستی توسط سرور دریافت، درک و پردازش شده و پاسخ استاندارد حاوی دادههای درخواستشده را بازگردانده است. طبق RFC 9110 (HTTP Semantics, 2022)، این کد برای موفقیت عمومی تمام متدهای HTTP استفاده میشود؛ در...
خطاهایی که در قالب Response دریافت میشود
این خطا ها در قالب Response False بصورت کد دریافت میشوند که میتوانید در متن خطا ها و راه حل آنها را در جدول زیر مشاهده نمائید. ردیف کد خطا عنوان راه حل 1 1000 ثبت این آیتم موفقیت آمیز بوده است در مواردی دیگر خطایی رخ داده است. 2 1...
دریافت جزئیات خطا از طریق API
عنوان وضعیت مقادیر توضیحات Method اجباری GET متد ارسال درخواست Domain اجباری نام دامنه ثبت شده در اتوماسیون Api Url اجباری دامنه هسته مرکزی سرویس Api version اجباری به نسخه فعلی سرویس API تلقی میشود که در قسمت ...
سربرگ – Header
در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید. {{Api Url}}/error-handling HEADER GET /api/reservation/{{Api version}}/error-handling HTTP/1.1 Host: {{Your Host}} Authorization: Bearer JWTToken Content-Type: application/json Domain:...
مقادیر ارسالی – Request Data
عنوان نوع وضعیت مقادیر توضیحات code Integer اختیاری نام کاربری دریافت شده در صورت وجود کد فقط کد مورد نظر بازگشت داده می شود. { "code": "Error Code" }
پاسخ صحیح – Response True
عنوان نوع مقادیر توضیحات status Boolean true مقدار در پاسخ صحیح همیشه true است time Timestamp زمان تولید پاسخ این زمان بر اساس timestamp می باشد – در صورت نیاز از این زمان استفاده شود. data Array data[Index].title Str...
پاسخ نادرست – Response False
عنوان نوع مقادیر توضیحات status Boolean false مقدار در پاسخ نادرست همیشه false است time Timestamp زمان تولید پاسخ این زمان بر اساس timestamp می باشد – در صورت نیاز از این زمان استفاده شود. code Integer شماره خطا مربوطه { ...
دریافت لیست ارور ها از طریق API
عنوان وضعیت مقادیر توضیحات Method اجباری GET متد ارسال درخواست Domain اجباری نام دامنه ثبت شده در اتوماسیون Api Url اجباری دامنه هسته مرکزی سرویس Api version اجباری به نسخه فعلی سرویس API تلقی میشود که در قسمت پیش ...
سربرگ – Header
در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید. {{Api Url}}/errors HEADER GET /api/reservation/{{Api version}}/errors HTTP/1.1 Host: {{Your Host}} Content-Type: application/json Domain: {{Your Domain}} API Url از طریق پنل کاربری قاب...