Create train order

POST

https://open.zhifeiair.com/api/v2/train/orders

create a train order

Request

Header Params

Body Params application/json

Example

{
    "train": {
        "from": "BJS",
        "to": "SHA",
        "date": "2024-08-01",
        "trainCode": "51",
        "seatClassId": "yingzuo",
        "passengers": [
            {
                "surname": "Pam",
                "givenName": "Marguerite",
                "birthday": "2005-07-19",
                "passengerType": "adult",
                "gender": "female",
                "nationality": "US",
                "travelDocument": "idcard",
                "travelDocumentNumber": "16",
                "travelDocumentExpiredAt": "2025-03-06"
            },
            {
                "surname": "Mr. Jermaine Wilderman",
                "givenName": "Dina",
                "birthday": "2025-02-25",
                "passengerType": "adult",
                "gender": "female",
                "nationality": "qui consectetur ea veniam",
                "travelDocument": "fpidcard",
                "travelDocumentNumber": "EY756745",
                "travelDocumentExpiredAt": "2025-03-07 04:17:05"
            },
            {
                "surname": "Melanie",
                "givenName": "Darrin",
                "birthday": "2004-04-06",
                "passengerType": "infant",
                "gender": "male",
                "nationality": "HK",
                "travelDocument": "tphm",
                "travelDocumentNumber": "EH868973",
                "travelDocumentExpiredAt": "2025-03-07 04:27:19"
            }
        ]
    },
    "contact": {
        "contactName": "Elmer Doyle",
        "contactEmail": "Rupert.Balistreri@yahoo.com",
        "contactPhone": "(793) 528-4549"
    },
    "alterative": true
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://open.zhifeiair.com/api/v2/train/orders' \
--header 'code;' \
--header 'signature;' \
--header 'timestamp;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "train": {
        "from": "BJS",
        "to": "SHA",
        "date": "2024-08-01",
        "trainCode": "51",
        "seatClassId": "yingzuo",
        "passengers": [
            {
                "surname": "Pam",
                "givenName": "Marguerite",
                "birthday": "2005-07-19",
                "passengerType": "adult",
                "gender": "female",
                "nationality": "US",
                "travelDocument": "idcard",
                "travelDocumentNumber": "16",
                "travelDocumentExpiredAt": "2025-03-06"
            },
            {
                "surname": "Mr. Jermaine Wilderman",
                "givenName": "Dina",
                "birthday": "2025-02-25",
                "passengerType": "adult",
                "gender": "female",
                "nationality": "qui consectetur ea veniam",
                "travelDocument": "fpidcard",
                "travelDocumentNumber": "EY756745",
                "travelDocumentExpiredAt": "2025-03-07 04:17:05"
            },
            {
                "surname": "Melanie",
                "givenName": "Darrin",
                "birthday": "2004-04-06",
                "passengerType": "infant",
                "gender": "male",
                "nationality": "HK",
                "travelDocument": "tphm",
                "travelDocumentNumber": "EH868973",
                "travelDocumentExpiredAt": "2025-03-07 04:27:19"
            }
        ]
    },
    "contact": {
        "contactName": "Elmer Doyle",
        "contactEmail": "Rupert.Balistreri@yahoo.com",
        "contactPhone": "(793) 528-4549"
    },
    "alterative": true
}'

Responses

🟢200OK

application/json

Body

Example

{
    "code": 0,
    "data": {
        "id": "string",
        "departureStation": {
            "code": "string",
            "name": "string",
            "altName": "string"
        },
        "departureDate": "string",
        "departureTime": "string",
        "arrivalStation": {
            "code": "string",
            "name": "string",
            "altName": "string"
        },
        "travelDays": 0,
        "arrivalTime": "string",
        "trainCode": "string",
        "trainType": "string",
        "duration": "string",
        "seatClassId": "string",
        "seatClassName": "string",
        "alterative": true,
        "estimateIssueTime": "string",
        "contactName": "string",
        "contactEmail": "string",
        "contactPhone": "string",
        "totalPrice": 0,
        "tickets": [
            {
                "id": 0,
                "surname": "string",
                "givenNames": "string",
                "birthday": "string",
                "passengerType": "adult",
                "gender": "male",
                "nationality": "string",
                "travelDocument": "passport",
                "travelDocumentNumber": "string",
                "travelDocumentExpireDate": "string",
                "ticketPrice": 0,
                "serviceFee": 0,
                "confirmationNumber": "string",
                "carNumber": "string",
                "seatNumber": "string",
                "status": "pending",
                "estimateRefund": "string",
                "createdAt": "string",
                "updatedAt": "string"
            }
        ],
        "status": "pending",
        "createdAt": "string",
        "updatedAt": "string"
    },
    "message": "string",
    "realMessage": "string"
}

Train shopping

Order detail