FR24 OpenAPI
  1. API 参考
FR24 OpenAPI
  • FR24_API_V2.0
    • 指南
      • API调用流程
      • 介绍
      • 附录
      • 版本历史
      • 错误码
    • API 参考
      • shopping 航班搜索接口
        POST
      • pricing 校验接口
        POST
      • presaleAncillaryShopping 售前辅营搜索接口
        POST
      • seatMap 机型图接口
        POST
      • booking 生单接口
        POST
      • ticketing 申请出票接口
        POST
      • orderChangeInforming 订单信息变更通知
        POST
      • orderDetail 订单详情接口
        POST
      • postsaleAncillaryShopping 售后行李搜索接口
        POST
      • ancillaryBooking 辅营生单接口
        POST
      • ancillaryPurchase 辅营支付接口
        POST
      • ancillaryOrderDetail 辅营订单详情
        POST
      • changeReshop 改期搜索接口
        POST
      • reissueRequest 改期申请接口
        POST
      • refundRequest 退票申请接口
        POST
      • refundConfirming 退票确认接口
        POST
      • voidRequest 废票提交接口
        POST
      • fileUpload 文件上传
        POST
      • selectBalance 余额查询接口
        POST
    • 关于我们
      • API 能力
      • 商务合作
      • 门户网站
  1. API 参考

shopping 航班搜索接口

POST
/api/new/shopping.do
通过Shopping接口,查询可用航班信息。支持单程、往返程、缺口程线路查询。

请求参数

Header 参数

Body 参数application/json

示例
{
    "authentication": {
        "sign": "{{sign}}",
        "timestamp": "{{timestamp}}"
    },
    "searchLegs": [
        {
            "typeO": "airportgroup",
            "origin": "SIN",
            "typeD": "airportcode",
            "destination": "HKG",
            "depDate": "2025-11-15"
        }
    ],
    "adultNum": 2,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": "Y",
        "preferredCarrier": [
            "AB"
        ],
        "prohibitedCarrier": [
            "CD"
        ],
        "stops": 0
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://flight-test.flightroutes24.com/api/new/shopping.do' \
--header 'Accept-Encoding;' \
--header 'appKey;' \
--header 'content-Type: application/json' \
--data-raw '{
    "authentication": {
        "sign": "",
        "timestamp": ""
    },
    "searchLegs": [
        {
            "typeO": "airportgroup",
            "origin": "SIN",
            "typeD": "airportcode",
            "destination": "HKG",
            "depDate": "2025-11-15"
        }
    ],
    "adultNum": 2,
    "childNum": 0,
    "infantNum": 0,
    "preferences": {
        "cabin": "Y",
        "preferredCarrier": [
            "AB"
        ],
        "prohibitedCarrier": [
            "CD"
        ],
        "stops": 0
    }
}'

返回响应

🟢200OK
application/json
Body

示例
{
    "traceId": "queryFlight_NEWAPI250117113553863087",
    "code": "000000",
    "message": "成功",
    "processingTime": 1717,
    "data": {
        "offers": [
            {
                "offerId": "18599004604928000",
                "legId": "1ebb56358b1c617a18a597543feceb77",
                "currency": "CNY",
                "platingCarrier": "CX",
                "pricePerPax": [
                    {
                        "paxType": "ADT",
                        "baseFare": 581,
                        "totalTax": 493,
                        "taxBreakdown": [],
                        "serviceFee": 10000
                    }
                ],
                "cabin": [
                    "Y"
                ],
                "fareBasis": [
                    "QR21SGAO"
                ],
                "availability": [
                    "9"
                ],
                "extraInfo": {
                    "freeBaggageAllowance": [
                        {
                            "segmentId": "4453068fd343a3eb89b823fc48cc2cd9",
                            "cabinBagPc": "1-e-e",
                            "cabinBagSize": "e-e-e",
                            "cabinBagWeight": "7-e-e",
                            "checkedBagPc": "1-e-e",
                            "checkedBagSize": "e-e-e",
                            "checkedBagWeight": "e-e-e"
                        }
                    ]
                },
                "eligibilityFlag": false,
                "eligibilityDetail": null,
                "rules": {
                    "refund": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "refundPolicy": "withCondition",
                            "applicableTime": [
                                null,
                                0
                            ],
                            "fullRefundAP": null,
                            "refundFee": 1539
                        },
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "refundPolicy": "notAllowed",
                            "applicableTime": [
                                0,
                                null
                            ],
                            "fullRefundAP": null,
                            "refundFee": null
                        }
                    ],
                    "change": [
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "changePolicy": "withCondition",
                            "applicableTime": [
                                null,
                                0
                            ],
                            "changeFee": 513
                        },
                        {
                            "paxType": "ADT",
                            "couponStatus": 0,
                            "changePolicy": "notAllowed",
                            "applicableTime": [
                                0,
                                null
                            ],
                            "changeFee": null
                        }
                    ]
                },
                "productType": null,
                "productTag": {
                    "ticketPromise": null,
                    "refuseDeadline": null,
                    "ticketingTime": null,
                    "reschedulePendingTime": null,
                    "voluntaryRefundTime": null,
                    "involuntaryRefundTime": null,
                    "refundCondition": null,
                    "reissueCondition": null,
                    "voidingCondition": false,
                    "voluntaryServiceStandard": null,
                    "involuntaryServiceStandard": null,
                    "rescheduleProcessingTime": null,
                    "productSupplier": null,
                    "RBDChangedRisk": false,
                    "fareBrand": [
                        ""
                    ],
                    "posArea": [
                        null
                    ]
                },
                "productSource": "OTH",
                "RBD": [
                    "Q"
                ]
            },
            {
                "offerId": "18599004604928001",
                "legId": "d983cf575abe2d3ffad742382ab681db",
                "currency": "CNY",
                "platingCarrier": "CX",
                "pricePerPax": [
                    {
                        "paxType": "ADT",
                        "baseFare": 581,
                        "totalTax": 493,
                        "taxBreakdown": [],
                        "serviceFee": 10000
                    }
                ],
                "cabin": [
  
修改于 2025-06-12 09:36:24
上一页
错误码
下一页
pricing 校验接口
Built with