航班查询 - STTS OPEN API

按行程、舱等、乘客数量和过滤条件查询航班方案。

关键过滤口径：

origin / destination 可传城市或机场三字码；机场码在供应商路由和缓存键计算前归一化为所属城市码，响应航段仍返回实际机场。

includeAirlines / excludeAirlines 均按实际承运航司过滤，不按销售航司过滤。

flightsAllowedOperatingCarriers 作为额外的承运航司白名单；命中 LinkstarGDS 禁用名单时跳过该供应商查询。

maxPrice 按加价和政策后的最终价过滤。

alliances 为后置联盟过滤。

maxWaitTime 与 OTA 配置 CircuitBreakerDuration 和默认 30000ms 取最小正数。

Request

Authorization

API Key

Add parameter in header

code

Example:

code: ********************

API Key

Add parameter in header

timestamp

Example:

timestamp: ********************

API Key

Add parameter in header

signature

Example:

signature: ********************

Header Params

Body Params application/jsonRequired

Example

{
    "journeys": [
        {
            "origin": "BJS",
            "destination": "BKK",
            "departureDate": "2026-08-01"
        }
    ],
    "cabinClass": "economy",
    "passengers": {
        "adult": 1,
        "child": 0,
        "infant": 0
    },
    "includeAirlines": [
        "CX"
    ],
    "alliances": [
        "OW"
    ],
    "requirements": {
        "freeBaggage": true,
        "noMultiAirport": true
    },
    "configs": {
        "allowedTransport": [
            "AIR"
        ],
        "approachDepartureTime": 6
    },
    "maxWaitTime": 20000
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200

application/json

查询成功。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "ok",
    "realErrorMsg": "",
    "data": {
        "searchKey": "sk_001",
        "cursor": 0,
        "more": false,
        "segments": {
            "property1": {
                "id": "PEK-SHA-20260801-CA1234",
                "airline": "CA",
                "flightNo": "CA1234",
                "isCodeShare": false,
                "opAirline": "CA",
                "opFlightNo": "CA1234",
                "equipment": "738",
                "mealType": "Meal",
                "departure": "PEK",
                "departureDate": "2026-08-01",
                "departureTime": "08:00",
                "departureTerminal": "T3",
                "arrival": "SHA",
                "arrivalDate": "2026-08-01",
                "arrivalTime": "10:20",
                "arrivalTerminal": "T2",
                "distance": 1080,
                "flightTime": "2h20m",
                "stopovers": [
                    {
                        "city": "HGH",
                        "airport": "HGH",
                        "duration": "1h10m",
                        "arrivalTime": "10:00",
                        "departureTime": "11:10"
                    }
                ]
            },
            "property2": {
                "id": "PEK-SHA-20260801-CA1234",
                "airline": "CA",
                "flightNo": "CA1234",
                "isCodeShare": false,
                "opAirline": "CA",
                "opFlightNo": "CA1234",
                "equipment": "738",
                "mealType": "Meal",
                "departure": "PEK",
                "departureDate": "2026-08-01",
                "departureTime": "08:00",
                "departureTerminal": "T3",
                "arrival": "SHA",
                "arrivalDate": "2026-08-01",
                "arrivalTime": "10:20",
                "arrivalTerminal": "T2",
                "distance": 1080,
                "flightTime": "2h20m",
                "stopovers": [
                    {
                        "city": "HGH",
                        "airport": "HGH",
                        "duration": "1h10m",
                        "arrivalTime": "10:00",
                        "departureTime": "11:10"
                    }
                ]
            }
        },
        "solutions": [
            {
                "solutionId": "sol_2f4d3c",
                "source": "",
                "orderKey": "ok_9ecf",
                "priceDetail": {
                    "invoiceType": "normal",
                    "issuingAirline": "CA",
                    "saleAirline": "CA",
                    "productType": "publish",
                    "maxCount": 9,
                    "limitInfo": {
                        "nationalityAllows": [
                            "CN"
                        ],
                        "nationalityForbids": [
                            "US"
                        ],
                        "agePairs": [
                            {
                                "maxAge": 65,
                                "minAge": 18
                            }
                        ],
                        "allowedTravelDocuments": [
                            "passport"
                        ],
                        "passengerQualification": "",
                        "groupInfo": {
                            "max": 9,
                            "min": 2
                        }
                    },
                    "priceList": [
                        {
                            "passengerType": "adult",
                            "fareBasisCode": "YOWCN",
                            "brandCode": "ECONOMY",
                            "num": 1,
                            "publishPrice": 1000,
                            "price": 950,
                            "salePrice": 1000,
                            "tax": 200,
                            "currency": "CNY",
                            "taxDetail": [
                                {
                                    "type": "YQ",
                                    "amount": 100
                                }
                            ],
                            "discount": 100
                        }
                    ],
                    "officeNo": "BJS123",
                    "accountCode": "CORP001",
                    "isSelfProduct": false,
                    "isPrivate": false,
                    "productFlag": "",
                    "productName": "Economy Saver"
                },
                "journeys": [
                    {
                        "origin": "BJS",
                        "destination": "BKK",
                        "departureDate": "2026-08-01",
                        "departureTime": "08:00",
                        "departureTimeZone": "Asia/Shanghai",
                        "arrivalDate": "2026-08-01",
                        "arrivalTime": "15:00",
                        "arrivalTimeZone": "Asia/Bangkok",
                        "duration": "7h00m",
                        "transferNum": 1,
                        "segments": [
                            {
                                "coreSegmentId": "PEK-SHA-20260801-CA1234",
                                "cabinClass": "economy",
                                "cabinCode": "Y",
                                "subCabinCode": "Y1",
                                "fareBasis": "YOWCN",
                                "brandCode": "ECONOMY",
                                "availability": 9,
                                "stayTime": "2h10m"
                            }
                        ]
                    }
                ],
                "fareRules": {
                    "PEKSHA": [
                        {
                            "passengerType": "adult",
                            "canVoid": true,
                            "currency": "CNY",
                            "change": {
                                ">0": 300,
                                ">4": 200,
                                "<-4": 500
                            },
                            "refund": {
                                ">0": 500,
                                ">4": 300,
                                "<-4": 800
                            }
                        }
                    ]
                },
                "baggageRules": {
                    "PEKSHA": [
                        {
                            "passengerType": "adult",
                            "carryOn": {
                                "pieces": 1,
                                "weight": 7,
                                "unit": "KG"
                            },
                            "checked": {
                                "pieces": 1,
                                "weight": 23,
                                "unit": "KG"
                            }
                        }
                    ]
                },
                "requiredPassengerInfos": [
                    "type"
                ]
            }
        ]
    }
}

⚪default