لیست سرویس‌ها

• صفحه اول
• معرفی
• نکات کلی فنی
• Journey Search Panel
• پرواز
  • لیست پروازها
    • Price Matrix

متد Journey Search Panel

Download Markdown for LLM

توضیحات کلی

این متد برای دریافت داده‌های اولیه پنل جستجوی سفر (Journey Search Panel) استفاده می‌گردد. با فراخوانی این متد، اطلاعات لازم برای نمایش و پیش‌فرض‌سازی فرم جستجوی پرواز در رابط کاربری شما دریافت می‌شود، از جمله:

• تاریخ پیش‌فرض رفت (برابر با تاریخ جاری)
• تاریخ پیش‌فرض برگشت (برابر با تاریخ جاری به‌علاوه ۲ روز)
• لیست کامل فرودگاه‌ها برای نمایش در منوی انتخاب مبدا و مقصد
• لیست فرودگاه‌های پرمصرف (۲۰ مورد اول) برای دسترسی سریع
• کد یاتا پیش‌فرض مبدا و مقصد

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

API Endpoint

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

Query String Parameters

• culture

  string

  required

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

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

نمونه Url

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

Response Parameters

• departureDate

  string

  تاریخ پیش‌فرض رفت با فرمت yyyy-MM-dd و میلادی. برابر با تاریخ جاری به وقت ایران است.

• returningDate

  string

  تاریخ پیش‌فرض برگشت با فرمت yyyy-MM-dd و میلادی. برابر با تاریخ جاری به وقت ایران به‌علاوه ۲ روز است.

• allAirportList

  Array of airports

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

  • allAirportList.iataCode

    string

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

  • allAirportList.desc

    string

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

  • allAirportList.searchList

    Array of strings

    لیست عبارات جستجو برای این فرودگاه. شامل کد یاتا، نام فرودگاه و حالت‌های مختلف املایی (با و بدون آلف) است. این فیلد برای فیلتر کردن و جستجو در منوی انتخاب فرودگاه استفاده می‌شود.

• frequentAirportList

  Array of airports

  لیست فرودگاه‌های پرمصرف. شامل ۲۰ مورد اول از allAirportList است. ساختار فیلدها مشابه allAirportList می‌باشد.

• defaultOriginIataCode

  string

  کد یاتا پیش‌فرض مبدا.

• defaultDestinationIataCode

  string

  کد یاتا پیش‌فرض مقصد.

Sample Response

{
    "departureDate": "2026-10-15",
    "returningDate": "2026-10-17",
    "allAirportList": [                
        {
            "iataCode": "ABD",
            "desc": "آبادان",
            "searchList": [
                "ABD",
                "Abadan",
                "آبادان",
                "ابادان"
            ]
        },
        {
            "iataCode": "AJK",
            "desc": "اراک",
            "searchList": [
                "AJK",
                "Arak",
                "اراک"
            ]
        },
        {
            "iataCode": "ADU",
            "desc": "اردبيل",
            "searchList": [
                "ADU",
                "Ardabil",
                "اردبيل",
                "اردبیل"
            ]
        }
    ],
    "frequentAirportList": [        
        {
            "iataCode": "ABD",
            "desc": "آبادان",
            "searchList": [
                "ABD",
                "Abadan",
                "آبادان",
                "ابادان"
            ]
        },
        {
            "iataCode": "AJK",
            "desc": "اراک",
            "searchList": [
                "AJK",
                "Arak",
                "اراک"
            ]
        },
        {
            "iataCode": "ADU",
            "desc": "اردبيل",
            "searchList": [
                "ADU",
                "Ardabil",
                "اردبيل",
                "اردبیل"
            ]
        }
    ],
    "defaultOriginIataCode": "THR",
    "defaultDestinationIataCode": "MHD"
}