مستندات

جست‌وجو در مستندات

نام اندپوینت، موضوع یا کلیدواژه را بنویسید

دریافت اطلاعات رزرو پرواز

برنامهٔ سفر کامل، مسافران، قیمت و وضعیت یک رزرو را هر زمان که خواستید بخوانید.

POST/Air/AirBookingData

دسترسی نیازمند مجوز air_booking_data

رزرو را با UniqueIdای که از رزرو گرفته‌اید یا با ClientUniqueIdای که خودتان تعیین کرده‌اید پیدا کنید. دست‌کم یکی از این دو را بفرستید. از این اندپوینت برای پیگیری دوره‌ای وضعیت، نمایش برنامهٔ سفر به مسافر و خواندن شماره‌های بلیت صادرشده استفاده کنید.

پارامترهای مسیر#

ندارد.

پارامترهای کوئری#

ندارد.

پارامترهای بدنه#

نامنوعالزامیتوضیح
SessionIdstringالزامیشناسهٔ نشست شما.
UniqueIdstringیکی از دوشناسهٔ رزروی که از رزرو گرفته‌اید.
ClientUniqueIdstringیکی از دوشناسهٔ مرجع خودتان که هنگام رزرو فرستاده‌اید. دست‌کم یکی از UniqueId یا ClientUniqueId را بفرستید.

درخواست#

curl -X POST https://api.simorghapi.com/api/Air/AirBookingData \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "UniqueId": "TP-2026-000512"
  }'
const res = await fetch("https://api.simorghapi.com/api/Air/AirBookingData", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    UniqueId: "TP-2026-000512"
  })
});

const data = await res.json();
import requests

res = requests.post(
    "https://api.simorghapi.com/api/Air/AirBookingData",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "UniqueId": "TP-2026-000512",
    },
)

data = res.json()

پاسخ#

فیلدنوعتوضیح
Successbooleanدر صورت موفقیت true.
UniqueIdstringشناسهٔ رزرو.
ParentUniqueIdstringشناسهٔ رزرو والد، در صورتی که رزرو دوباره صادر شده باشد.
Categoryintegerکد دستهٔ رزرو: 10 رزرو شده، 20 بلیت صادر شده.
Statusintegerکد وضعیت رزرو: 10 رزرو شده، 20 بلیت صادر شده.
TktTimeLimitstringمهلت صدور بلیت، تا زمانی که رزرو نگه داشته شده است.
TktTimeLimitTimeZonestringمنطقهٔ زمانی TktTimeLimit.
ValidatingAirlineCodestringایرلاین صادرکننده (Validating Airline).
TravelItineraryobjectبرنامهٔ سفر، مسافران و قیمت. جزئیات در ادامه.
Errorobjectدر صورت موفقیت null.
TravelItinerary.ItineraryInfo object
فیلدنوعتوضیح
ItineraryPricingobjectBaseFare، TotalTax، TotalFare، Currency و فیلدهای کمیسیون. همهٔ مبالغ به دلار آمریکا (USD) هستند.
CustomerInfoesarray of objectمشخصات مسافران، همان‌طور که رزرو شده‌اند.
ReservationItemsarray of objectسگمنت‌های پرواز؛ پس از صدور، شماره‌های بلیت هم در آن‌ها می‌آید.
TripDetailPtcFareBreakdownsarray of objectنرخ به تفکیک نوع مسافر.
PhoneNumberstringشمارهٔ تلفن مخاطب اصلی.
Emailstringایمیل مخاطب اصلی.
 
{
  "Success": true,
  "UniqueId": "TP-2026-000512",
  "ParentUniqueId": null,
  "Category": 20,
  "Status": 20,
  "TktTimeLimit": null,
  "TktTimeLimitTimeZone": "UTC",
  "ValidatingAirlineCode": "TK",
  "TravelItinerary": {
    "ItineraryInfo": {
      "ItineraryPricing": {
        "BaseFare": 182.40,
        "TotalTax": 37.20,
        "TotalFare": 219.60,
        "Currency": "USD"
      },
      "CustomerInfoes": [
        {
          "PassengerType": 1,
          "PassengerFirstName": "Jane",
          "PassengerLastName": "Doe"
        }
      ],
      "ReservationItems": [
        {
          "DepartureAirportLocationCode": "IST",
          "ArrivalAirportLocationCode": "DXB",
          "FlightNumber": "764",
          "AirlinePNR": "ABC123",
          "TicketNumber": "235-1234567890"
        }
      ],
      "PhoneNumber": "+441234567890",
      "Email": "traveller@example.com"
    }
  },
  "Error": null
}

خطاها#

کدمعناراه‌حل
Err0106002نه UniqueId ارسال شده و نه ClientUniqueId.دست‌کم یکی را بفرستید.
Err0103003رزرو پیدا نشد.شناسه را بررسی کنید.
ویرایش این صفحه در گیت‌هابمشکلی دیدید؟ از پنل ← پشتیبانی خبرمان کنید.