行李直挂 / 中转行李查询

POST

/openapi/v3/flight/baggage-transit

根据行程航段查询中转签证提醒和行李直挂信息。

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

Body Params application/jsonRequired

Example

{
    "tripType": "oneway",
    "legs": [
        {
            "departureCity": "BJS",
            "arrivalCity": "BKK",
            "segments": [
                {
                    "flightNo": "CA1234",
                    "departureAirport": "PEK",
                    "arrivalAirport": "HKG",
                    "departureDate": "2026-08-01",
                    "departureTime": "08:00",
                    "arrivalDate": "2026-08-01",
                    "arrivalTime": "12:00",
                    "departureTerminal": "T3",
                    "arrivalTerminal": "T1",
                    "opAirline": "CA",
                    "opFlightNo": "CA1234",
                    "stopInfoList": [
                        {
                            "portCode": "HKG",
                            "duration": 90,
                            "arrDatetime": "2026-08-01 12:00"
                        }
                    ]
                }
            ]
        }
    ]
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location '/openapi/v3/flight/baggage-transit' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "tripType": "oneway",
    "legs": [
        {
            "departureCity": "BJS",
            "arrivalCity": "BKK",
            "segments": [
                {
                    "flightNo": "CA1234",
                    "departureAirport": "PEK",
                    "arrivalAirport": "HKG",
                    "departureDate": "2026-08-01",
                    "departureTime": "08:00",
                    "arrivalDate": "2026-08-01",
                    "arrivalTime": "12:00",
                    "departureTerminal": "T3",
                    "arrivalTerminal": "T1",
                    "opAirline": "CA",
                    "opFlightNo": "CA1234",
                    "stopInfoList": [
                        {
                            "portCode": "HKG",
                            "duration": 90,
                            "arrDatetime": "2026-08-01 12:00"
                        }
                    ]
                }
            ]
        }
    ]
}'

Responses

🟢200

application/json

查询成功。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "ok",
    "realErrorMsg": "",
    "data": [
        {
            "departureCity": "BJS",
            "arrivalCity": "BKK",
            "segments": [
                {
                    "departureAirport": "HKG",
                    "arrivalAirport": "BKK",
                    "departureTime": "2026-08-01 14:00",
                    "entryVisaReminder": "No entry visa required",
                    "transitVisaReminder": "Check transit visa policy",
                    "baggageThrough": true
                }
            ]
        }
    ]
}

⚪default

Modified at 2026-07-21 08:28:46

确认航班退票单

查询航班票号状态