تقویم قیمت پرواز

ارزان‌ترین نرخ هر روز را برای یک مسیر بگیرید تا پیش از جست‌وجوی کامل، نمای «ارزان‌ترین تاریخ‌ها» را نشان دهید.

POST/Air/AirPriceCalendar

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

مبدأ، مقصد و یک ماه یا یک تاریخ را بفرستید. برای هر روز، ارزان‌ترین نرخ را دریافت می‌کنید. قیمت‌های این اندپوینت تقریبی‌اند؛ برای گرفتن نرخ‌های قابل رزرو، یک جست‌وجوی کامل اجرا کنید.

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

ندارد.

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

ندارد.

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

نام	نوع	الزامی	پیش‌فرض	توضیح
`Origin`	string	الزامی	-	کد IATA مبدأ؛ سه حرف، مثلاً `IST`.
`Destination`	string	الزامی	-	کد IATA مقصد؛ سه حرف، مثلاً `DXB`.
`DepartDate`	string	الزامی	-	یک ماه به قالب `YYYY-MM` یا یک روز به قالب `YYYY-MM-DD`.
`TripType`	string	اختیاری	رفت‌وبرگشت	برای یک‌طرفه `oneway`. هر مقدار دیگری رفت‌وبرگشت در نظر گرفته می‌شود.
`ReturnDate`	string	اختیاری	-	یک ماه یا یک روز. برای رفت‌وبرگشت الزامی است.
`CalendarType`	string	اختیاری	`departure_date`	تقویم بر اساس `departure_date` (تاریخ رفت) یا `return_date` (تاریخ برگشت) ساخته شود.
`Currency`	string	اختیاری	`USD`	کد سه‌حرفی واحد پول.

درخواست#

curl -X POST https://api.simorghapi.com/api/Air/AirPriceCalendar \
  -H "Content-Type: application/json" \
  -d '{
    "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    "Origin": "IST",
    "Destination": "DXB",
    "DepartDate": "2026-10",
    "TripType": "oneway",
    "Currency": "USD"
  }'

const res = await fetch("https://api.simorghapi.com/api/Air/AirPriceCalendar", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    SessionId: "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
    Origin: "IST",
    Destination: "DXB",
    DepartDate: "2026-10",
    TripType: "oneway",
    Currency: "USD"
  })
});

const data = await res.json();

import requests

res = requests.post(
    "https://api.simorghapi.com/api/Air/AirPriceCalendar",
    json={
        "SessionId": "8f3c81d2-4a5b-4c6d-9e0f-1a2b3c4d5e6f",
        "Origin": "IST",
        "Destination": "DXB",
        "DepartDate": "2026-10",
        "TripType": "oneway",
        "Currency": "USD",
    },
)

data = res.json()

پاسخ#

فیلد	نوع	توضیح
`Success`	boolean	در صورت موفقیت `true`.
`Origin` / `Destination`	string	مسیری که درخواست کرده‌اید.
`TripType`	string	`OneWay` یا `RoundTrip`.
`CalendarType`	string	`departure_date` یا `return_date`.
`Currency`	string	واحد پول همهٔ قیمت‌ها.
`DaysCount`	integer	تعداد روزهای برگشتی.
`MinPrice` / `MaxPrice`	number	قیمت ارزان‌ترین و گران‌ترین روز.
`Cheapest`	object	ارزان‌ترین روز، با همان ساختار یک مورد از `Days`.
`Days`	array of object	برای هر روز یک مورد. جزئیات در ادامه.
`Error`	object	در صورت موفقیت `null`.

Days[] object

فیلد	نوع	توضیح
`Date`	string	روز، به قالب `YYYY-MM-DD`.
`Price`	number	ارزان‌ترین نرخ آن روز.
`Currency`	string	واحد پول `Price`.
`Transfers`	integer	تعداد توقف‌های ارزان‌ترین گزینه.
`Airline`	string	کد ایرلاین ارزان‌ترین گزینه.
`FlightNumber`	string	شمارهٔ پرواز ارزان‌ترین گزینه.
`DepartureAt`	string	زمان حرکت.
`ReturnAt`	string	زمان برگشت، برای رفت‌وبرگشت.
`ExpiresAt`	string	زمان انقضای این قیمت.
`Origin` / `Destination`	string	مسیر این مورد.

{
  "Success": true,
  "Origin": "IST",
  "Destination": "DXB",
  "TripType": "OneWay",
  "CalendarType": "departure_date",
  "Currency": "USD",
  "DaysCount": 2,
  "MinPrice": 198.00,
  "MaxPrice": 233.00,
  "Cheapest": {
    "Date": "2026-10-12",
    "Price": 198.00,
    "Currency": "USD",
    "Transfers": 0,
    "Airline": "TK",
    "FlightNumber": "764",
    "DepartureAt": "2026-10-12T08:25:00",
    "ReturnAt": null,
    "ExpiresAt": "2026-09-20T10:00:00",
    "Origin": "IST",
    "Destination": "DXB"
  },
  "Days": [
    {
      "Date": "2026-10-12",
      "Price": 198.00,
      "Currency": "USD",
      "Transfers": 0,
      "Airline": "TK",
      "FlightNumber": "764",
      "DepartureAt": "2026-10-12T08:25:00",
      "ReturnAt": null,
      "ExpiresAt": "2026-09-20T10:00:00",
      "Origin": "IST",
      "Destination": "DXB"
    },
    {
      "Date": "2026-10-13",
      "Price": 233.00,
      "Currency": "USD",
      "Transfers": 1,
      "Airline": "GF",
      "FlightNumber": "552",
      "DepartureAt": "2026-10-13T02:10:00",
      "ReturnAt": null,
      "ExpiresAt": "2026-09-20T10:00:00",
      "Origin": "IST",
      "Destination": "DXB"
    }
  ],
  "Error": null
}

خطاها#

کد	معنا	راه‌حل
`Err0106001`	یک فیلد ارسال نشده یا نامعتبر است؛ مثلاً `ReturnDate` در سفر رفت‌وبرگشت ارسال نشده است.	فیلدی را که در پیام آمده اصلاح کنید.
`Err0500003`	برای این مسیر و تاریخ‌ها دادهٔ تقویمی وجود ندارد.	ماه یا مسیر دیگری را امتحان کنید.

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