مستندات وب سرویس

متد Price Matrix

Download Markdown for LLM

توضیحات کلی

این متد برای دریافت ماتریس ارزان‌ترین پروازها (Price Matrix) استفاده می‌گردد. با فراخوانی این متد، برای هر مبدا، ارزان‌ترین پروازهای موجود به مقاصد مختلف به همراه تاریخ، شماره پرواز، قیمت و نام fare برگشت داده می‌شود.

این اطلاعات برای نمایش یک نمای کلی از ارزان‌ترین مسیرها و قیمت‌ها در رابط کاربری شما کاربرد دارد. نام نمایشی فرودگاه‌ها بر اساس زبان درخواستی (culture) برگشت داده می‌شود.

نکته: به‌منظور پردازش سریع‌تر درخواست‌ها، خروجی این متد به مدت یک دقیقه در حافظه موقت (Cache) نگهداری می‌شود. بنابراین، پس از تغییر نرخ پروازها، ممکن است اعمال تغییرات در خروجی این متد تا حداکثر یک دقیقه زمان ببرد.


API Endpoint

GET https://{SupplierWebsiteUrl}/api/ThirdParties/B2C/Headless/FlightList/PriceMatrix/V1?culture={Culture}

Query String Parameters

  • culture

    string

    required

    زبان نمایش اطلاعات به کاربر.

    یکی از موارد fa-IR یا en-US یا ar-IQ می‌تواند باشد.


نمونه Url

https://SepehrApiTest.ir/api/ThirdParties/B2C/Headless/FlightList/PriceMatrix/V1?culture=fa-IR

Response Parameters

  • cheapestFlightByOriginList

    Array of cheapestFlightByOrigin

    لیست ارزان‌ترین پروازها گروه‌بندی‌شده بر اساس مبدا.

    • cheapestFlightByOriginList.origin

      object

      فرودگاه مبدا.

      • cheapestFlightByOriginList.origin.iataCode

        string

        کد یاتا فرودگاه مبدا.

      • cheapestFlightByOriginList.origin.desc

        string

        نام نمایشی فرودگاه مبدا به زبان درخواستی.

    • cheapestFlightByOriginList.cheapestFlightByDestinationAndDateList

      Array of cheapestFlightByDestinationAndDate

      لیست ارزان‌ترین پروازهای این مبدا به مقاصد مختلف.

      • cheapestFlightByOriginList.cheapestFlightByDestinationAndDateList.destination

        object

        فرودگاه مقصد.

        • cheapestFlightByOriginList.cheapestFlightByDestinationAndDateList.destination.iataCode

          string

          کد یاتا فرودگاه مقصد.

        • cheapestFlightByOriginList.cheapestFlightByDestinationAndDateList.destination.desc

          string

          نام نمایشی فرودگاه مقصد به زبان درخواستی.

      • cheapestFlightByOriginList.cheapestFlightByDestinationAndDateList.cheapestFlightDate

        string

        تاریخ ارزان‌ترین پرواز با فرمت yyyy-MM-dd و میلادی.

      • cheapestFlightByOriginList.cheapestFlightByDestinationAndDateList.cheapestFlightNumber

        string

        شماره پرواز ارزان‌ترین.

      • cheapestFlightByOriginList.cheapestFlightByDestinationAndDateList.cheapestFlightPrice

        string

        قیمت ارزان‌ترین پرواز به صورت اعداد فرمت‌شده (با جداکننده هزارگان).

      • cheapestFlightByOriginList.cheapestFlightByDestinationAndDateList.fareName

        string

        نام fare کلاس پروازی.


Sample Response

{
    "cheapestFlightByOriginList": [
        {
            "origin": {
                "iataCode": "IKA",
                "desc": "تهران امام خميني"
            },
            "cheapestFlightByDestinationAndDateList": [
                {
                    "destination": {
                        "iataCode": "IFN",
                        "desc": "اصفهان"
                    },
                    "cheapestFlightDate": "2026-10-15",
                    "cheapestFlightNumber": "3215",
                    "cheapestFlightPrice": "2,550,000",
                    "fareName": "IKAADB XC 2550"
                },
                {
                    "destination": {
                        "iataCode": "IST",
                        "desc": "استانبول فرودگاه جديد"
                    },
                    "cheapestFlightDate": "2026-10-16",
                    "cheapestFlightNumber": "8456",
                    "cheapestFlightPrice": "1,350,000",
                    "fareName": "IKAIST HH 1350"
                }
            ]
        },
        {
            "origin": {
                "iataCode": "AWZ",
                "desc": "اهواز"
            },
            "cheapestFlightByDestinationAndDateList": [
                {
                    "destination": {
                        "iataCode": "IFN",
                        "desc": "اصفهان"
                    },
                    "cheapestFlightDate": "2026-10-16",
                    "cheapestFlightNumber": "240",
                    "cheapestFlightPrice": "100,000",
                    "fareName": "AWZIFN IR 100"
                },
                {
                    "destination": {
                        "iataCode": "KIH",
                        "desc": "کيش"
                    },
                    "cheapestFlightDate": "2026-10-16",
                    "cheapestFlightNumber": "456",
                    "cheapestFlightPrice": "655,000",
                    "fareName": "THRGSM I3 655"
                }
            ]
        },
        {
            "origin": {
                "iataCode": "KIH",
                "desc": "کيش"
            },
            "cheapestFlightByDestinationAndDateList": [
                {
                    "destination": {
                        "iataCode": "THR",
                        "desc": "تهران مهرآباد"
                    },
                    "cheapestFlightDate": "2026-10-15",
                    "cheapestFlightNumber": "5544",
                    "cheapestFlightPrice": "860,000",
                    "fareName": "MHDTBZ IS 860"
                }
            ]
        }
    ]
}