检查座位和价格 - 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

{
    "shoppingId": "train_shop_01J2X9D8Q1",
    "journeyId": "train_journey_G1_20260720",
    "returnJourneyId": "train_journey_G2_20260725",
    "passengerCountByType": {
        "adult": 1,
        "child": 1
    },
    "seatId": "erdengzuo"
}

Request Code Samples

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location '/train/openapi/v4/check-availability' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "shoppingId": "train_shop_01J2X9D8Q1",
    "journeyId": "train_journey_G1_20260720",
    "returnJourneyId": "train_journey_G2_20260725",
    "passengerCountByType": {
        "adult": 1,
        "child": 1
    },
    "seatId": "erdengzuo"
}'

Responses

🟢200

application/json

检查成功。

Bodyapplication/json

Example

{
    "code": 0,
    "message": "Success",
    "data": {
        "valid": true,
        "invalidMsg": "",
        "currency": "CNY",
        "passengerCountByType": {
            "adult": 1
        },
        "priceByType": {
            "property1": {
                "ticketPrice": 553,
                "issuedTicketPrice": 550,
                "amount": 573,
                "serviceFees": 20,
                "refundTicketPrice": 500,
                "changeRefundCost": 53,
                "refundFee": 10,
                "ticketPriceDiff": 3
            },
            "property2": {
                "ticketPrice": 553,
                "issuedTicketPrice": 550,
                "amount": 573,
                "serviceFees": 20,
                "refundTicketPrice": 500,
                "changeRefundCost": 53,
                "refundFee": 10,
                "ticketPriceDiff": 3
            }
        },
        "returnPriceByType": {
            "property1": {
                "ticketPrice": 553,
                "issuedTicketPrice": 550,
                "amount": 573,
                "serviceFees": 20,
                "refundTicketPrice": 500,
                "changeRefundCost": 53,
                "refundFee": 10,
                "ticketPriceDiff": 3
            },
            "property2": {
                "ticketPrice": 553,
                "issuedTicketPrice": 550,
                "amount": 573,
                "serviceFees": 20,
                "refundTicketPrice": 500,
                "changeRefundCost": 53,
                "refundFee": 10,
                "ticketPriceDiff": 3
            }
        },
        "total": {
            "ticketPrice": 553,
            "issuedTicketPrice": 550,
            "amount": 573,
            "serviceFees": 20,
            "refundTicketPrice": 500,
            "changeRefundCost": 53,
            "refundFee": 10,
            "ticketPriceDiff": 3
        }
    }
}

🟢200TrainBusinessError