航段报价 - CTO OPEN API Document

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: ********************

or

Body Params application/jsonRequired

Example

{
    "segments": [
        {
            "departure": "PEK",
            "arrival": "SHA",
            "departureDate": "2026-08-01",
            "cabinClass": "economy",
            "flightNo": "CA1234",
            "journeyIndex": 0
        }
    ],
    "passengers": {
        "adult": 1,
        "child": 0,
        "infant": 0
    },
    "maxPrice": 8899,
    "accountCode": [
        {
            "CA": {
                "corporate": "CORP001",
                "account": "ACC001"
            }
        }
    ],
    "itineraryRequired": false,
    "maxWaitTime": 20000
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location '/openapi/v3/flight/pricing' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "segments": [
        {
            "departure": "PEK",
            "arrival": "SHA",
            "departureDate": "2026-08-01",
            "cabinClass": "economy",
            "flightNo": "CA1234",
            "journeyIndex": 0
        }
    ],
    "passengers": {
        "adult": 1,
        "child": 0,
        "infant": 0
    },
    "maxPrice": 8899,
    "accountCode": [
        {
            "CA": {
                "corporate": "CORP001",
                "account": "ACC001"
            }
        }
    ],
    "itineraryRequired": false,
    "maxWaitTime": 20000
}'

Responses

🟢200

application/json

报价成功。data 为数组，当前实现通常返回一个元素。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "ok",
    "realErrorMsg": "",
    "data": [
        {
            "searchKey": "sk_001",
            "segments": [
                {
                    "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,
                                "serviceFee": 50
                            }
                        ]
                    },
                    "journeys": [
                        {
                            "origin": "BJS",
                            "destination": "BKK",
                            "departureDate": "2026-08-01",
                            "departureTime": "08:00",
                            "arrivalDate": "2026-08-01",
                            "arrivalTime": "15:00",
                            "duration": "7h00m",
                            "transferNum": 1,
                            "segments": [
                                {
                                    "coreSegmentId": "PEK-SHA-20260801-CA1234",
                                    "cabinClass": "economy",
                                    "cabinCode": "Y",
                                    "subCabinCode": "Y1",
                                    "fareBasis": "YOWCN",
                                    "brandCode": "ECONOMY",
                                    "availability": 9,
                                    "stayTime": "2h10m",
                                    "fareBasisCode": "YOWCN"
                                }
                            ]
                        }
                    ],
                    "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"
                                }
                            }
                        ]
                    }
                }
            ]
        }
    ]
}

⚪default