Skip to main content
Advanced Search
Search Terms
Content Type

Exact Matches
Tag Searches
Date Options
Updated after
Updated before
Created after
Created before

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 چارتری

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

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

قبل از شروع! پیش نیازها و شرایط اخذ API چارتری

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

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

قبل از شروع! پیش نیازها و شرایط اخذ API چارتری

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

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

قبل از شروع! پیش نیازها و شرایط اخذ API چارتری

پیش نیاز کار با این سرویس داشتن دانش فنی مانند (Rest-full API, JWT Authentication) و آشناییت کامل با عملیات های چارتری و رزرو بلیت، هتل و خدمات. جهت استفاده از سرویس ایرپلاس، نیاز است که IP شما در هسته مرکزی Trust گردد. Trust کردن تا 2 عدد IP به صورت رایگان...

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

قبل از شروع! پیش نیازها و شرایط اخذ API چارتری

لطفا دقت نموده که به همراه تمامی درخواست های خود، header های زیر را نیز ارسال نمای HTTP //(required) - 1 Content-Type: application/json; charset=utf-8 //(required) - 2 Accept: application/json //(required) - 3 Accept-Encoding: gzip, deflate استفا...

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

قبل از شروع! پیش نیازها و شرایط اخذ API چارتری

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

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

قبل از شروع! پیش نیازها و شرایط اخذ API چارتری

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

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

قبل از شروع! پیش نیازها و شرایط اخذ API چارتری

سرویس فعلی از متدهای زیر پشتیبانی می کند نام متد کاربرد توضیحات GET دریافت اطلاعات از ارسال اطلاعات محرمانه در این متد خودداری فرمائید POST ایجاد اطلاعات این متد مرسوم ترین روش ارسال داده می باشد PATCH ویرایش جزئی اطلاعات در ویر...

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

قبل از شروع! پیش نیازها و شرایط اخذ API چارتری

در حال حاضر طبق جدول ذیل ورژن 1 سرویس در حال اجرا می باشد. این ورژن از پایداری بسیار بالایی برخوردار است. همچنین کلیه موارد امنیتی در این نسخه بصورت کامل رعایت شده است. قابل توجه است در صورت تغییر ورژن از قبل اطلاع رسانی خواهد شد و مدت زمان معینی جهت مهاجرت ...

مقدمه ای بر Error Handling

قبل از شروع! مدیریت خطاها – Error handling

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

نحوه نگارش خطاها

قبل از شروع! مدیریت خطاها – Error handling

پاسخ نادرست – Response False یا همان مشکل در ارسال اطلاعات عنوان نوع مقادیر توضیحات status Boolean false مقدار در پاسخ نادرست همیشه false است time Timestamp زمان تولید پاسخ این زمان بر اساس timestamp می باشد – در صورت نیاز از ای...

Status Code – کدهای وضعیتی درخواست ها

قبل از شروع! مدیریت خطاها – Error handling

 وضعیت 200 — OK کد وضعیت 200 OK نشان می‌دهد که درخواست به‌درستی توسط سرور دریافت، درک و پردازش شده و پاسخ استاندارد حاوی داده‌های درخواست‌شده را بازگردانده است. طبق RFC 9110 (HTTP Semantics, 2022)، این کد برای موفقیت عمومی تمام متدهای HTTP استفاده می‌شود؛ در...

خطاهایی که در قالب Response دریافت میشود

قبل از شروع! مدیریت خطاها – Error handling

این خطا ها در قالب Response False بصورت کد دریافت میشوند که میتوانید در متن خطا ها و راه حل آنها را در جدول زیر مشاهده نمائید. ردیف کد خطا عنوان راه حل 1 1000 ثبت این آیتم موفقیت آمیز بوده است در مواردی دیگر خطایی رخ داده است. 2 1...

دریافت جزئیات خطا از طریق API

قبل از شروع! مدیریت خطاها – Error handling

عنوان وضعیت مقادیر توضیحات Method اجباری GET متد ارسال درخواست Domain اجباری نام دامنه ثبت شده در اتوماسیون   Api Url اجباری دامنه هسته مرکزی سرویس   Api version اجباری به نسخه فعلی سرویس API تلقی میشود که در قسمت ...

سربرگ – Header

قبل از شروع! مدیریت خطاها – Error handling

در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید. {{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

قبل از شروع! مدیریت خطاها – Error handling

عنوان نوع وضعیت مقادیر توضیحات code Integer اختیاری نام کاربری دریافت شده در صورت وجود کد فقط کد مورد نظر بازگشت داده می شود. { "code": "Error Code" }

پاسخ صحیح – Response True

قبل از شروع! مدیریت خطاها – Error handling

عنوان نوع مقادیر توضیحات status Boolean true مقدار در پاسخ صحیح همیشه true است time Timestamp زمان تولید پاسخ این زمان بر اساس timestamp می باشد – در صورت نیاز از این زمان استفاده شود. data Array     data[Index].title Str...

پاسخ نادرست – Response False

قبل از شروع! مدیریت خطاها – Error handling

عنوان نوع مقادیر توضیحات status Boolean false مقدار در پاسخ نادرست همیشه false است time Timestamp زمان تولید پاسخ این زمان بر اساس timestamp می باشد – در صورت نیاز از این زمان استفاده شود. code Integer شماره خطا مربوطه { ...

دریافت لیست ارور ها از طریق API

قبل از شروع! دریافت لیست خطا ها و راه حل ها – Get Er...

عنوان وضعیت مقادیر توضیحات Method اجباری GET متد ارسال درخواست Domain اجباری نام دامنه ثبت شده در اتوماسیون   Api Url اجباری دامنه هسته مرکزی سرویس   Api version اجباری به نسخه فعلی سرویس API تلقی میشود که در قسمت پیش ...

سربرگ – Header

قبل از شروع! دریافت لیست خطا ها و راه حل ها – Get Er...

در این روش شما باید درخواست خود را از طریق لینک زیر ارسال فرمائید. {{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 از طریق پنل کاربری قاب...