Advanced Search
Search Results
94 total results found
داشتن سرویس با قابلیت هاب ایرپلاس
یکی دیگر از پیش نیاز های اتصای به سرویس چارتری داشتن سرویس با قابلیت هاب ایرپلاس از مجموعه می باشد. این سرویس پس از گذراندن مراحل مختلف اخذ و پس از آن میتوانید از طریق پنل درخواست ارتباط خود را ارسال فرمائید.
تعاریف و اصطلاحات استفاده شده در مستندات
لطفا در هنگام استفاده از مستندات، تعاریف زیر را مد نظر داشته باشید: تامین کننده: منظور آژانس مسافرتی و یا سرویس است که شما در حال استفاده از 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 از طریق پنل کاربری قاب...
مقادیر ارسالی – Request Data
عنوان نوع وضعیت مقادیر توضیحات code Integer اختیاری error code در صورت عدم ارسال این کلید لیست کل ارور ها و راه های آن برگردانده میشود. { "code": error code }