خطاها

Travel API دو قالب خطا دارد. اندپوینت‌های پرواز، هتل و عمومی (Common) خطا را در بدنهٔ پاسخ گزارش می‌کنند. اندپوینت‌های تفریحات از کدهای وضعیت استاندارد HTTP استفاده می‌کنند.

خطاهای API مبتنی بر نشست#

اندپوینت‌های پرواز، هتل، عمومی و احراز هویت معمولاً حتی وقتی عملیات ناموفق است هم HTTP 200 برمی‌گردانند. به‌جای کد وضعیت، فیلد Success را بخوانید. در صورت خطا، Success برابر false است و Error یک شناسه و یک پیام دارد.

{
  "Success": false,
  "Error": {
    "Id": "Err0102005",
    "Message": "Fare has expired or is no longer available. Please search again."
  }
}

احراز هویت#

درخواست و اعتبارسنجی#

نرخ و جست‌وجو#

رزروها#

سرویس‌های بالادستی#

خطاهای تفریحات#

اندپوینت‌های تفریحات زیر Activity/v2/ کد وضعیت واقعی HTTP را برمی‌گردانند و یک شیء error در پاسخ دارند.

{
  "error": {
    "code": "not_found",
    "message": "Listing was not found or expired, provided UUID: d3bfa3e1-e",
    "http_code": 404
  },
  "timestamp": "2026-10-15T16:43:33.184+08:00"
}

مدیریت درست خطاها#

دو قاعده بیشتر موارد را پوشش می‌دهد. در API مبتنی بر نشست، پیش از خواندن محتوای پاسخ، بر اساس Success تصمیم بگیرید. وقتی خطای نشست (Err0101001 یا Err0101002) دیدید، دوباره احراز هویت کنید و یک بار درخواست را تکرار کنید.

نرخ‌ها عمر کوتاهی دارند. اگر رزرو با Err0102003 یا Err0102005 برگشت، قیمت تغییر کرده است. دوباره جست‌وجو و اعتبارسنجی مجدد کنید و پیش از دریافت هزینه، نرخ جدید را به مسافر نشان دهید.