- Flight
- Train
- 查询与预订
- 订单
- 退改签
- 车次与站点
- 合作方同步
- 12306
- 电子票
- Schemas
- ApiResponseBase
- ErrorResponse
- EmptyObject
- CabinClass
- PassengerType
- Gender
- TravelDocument
- AllianceCode
- TransportType
- RefundReason
- ChangeReason
- FlightOrderType
- FlightOrderStatus
- PaymentChannel
- ConfirmationType
- ConfirmationIata
- PassengerInfo
- FlightJourney
- PassengerCount
- AccountCode
- ShoppingRequirements
- ShoppingVirtualInterlineConfig
- ShoppingConfigs
- OpenAPIFlightShoppingReq
- PricingReqSegment
- FlightPricingReq
- AllCabinPriceReq
- SolutionValidateReq
- FareRulesReq
- CreateFlightOriginOrderRequest
- PassengerForCreateOriginOrder
- PayFlightOrderReq
- RefundChangeAvailabilityReq
- ChangeSearchReq
- ChangeSearchPassenger
- ChangeSearchJourney
- CreateChangeOrderReq
- ConfirmChangeOrderReq
- ChangeSegmentItem
- ChangeNewSegment
- RefundMoneySearchReq
- CreateFlightRefundOrderOpenAPIRequest
- BaggageTransitReq
- BaggageTransitLeg
- BaggageTransitSegment
- BaggageTransitStopInfo
- TicketStatusReq
- TicketStatusPassenger
- DownloadAirTicketItineraryRequest
- ConfirmationSheetPrice
- OpenAPIShoppingResp
- OpenAPICoreSegment
- StopOver
- OpenAPISolutionResp
- OpenAPIPriceDetail
- OpenAPILimitInfo
- FlightLimitAgePair
- FlightSolutionGroupInfo
- OpenAPIPrice
- OpenAPITax
- OpenAPIJourneyResp
- OpenAPISegmentInfo
- OpenAPIBaggageRule
- BaggageRuleDetail
- OpenAPIBaggageRules
- OpenAPIFareRules
- OpenAPIFareRule
- OpenAPIPricingResp
- OpenAPIPricingSolutionResp
- OpenAPIPricingPriceDetail
- OpenAPIPricingPrice
- OpenAPIPricingJourneyResp
- OpenAPIPricingSegmentInfo
- OpenAPIVerificationResp
- OpenAPIFareRulesResp
- OpenAPIOrderResp
- OpenAPIOrderJourney
- OpenAPIOrderSegment
- OpenAPIOrderCoreSegment
- OpenAPIOrderPassenger
- OpenAPIOrderTicket
- OpenAPIOrderPriceDetail
- OpenAPIOrderPrice
- OpenAPIOriginOrderPrice
- OpenAPIChangeOrderPrice
- OpenAPIRefundOrderPrice
- OpenAPIOrderListResp
- OpenAPIRefundChangeAvailabilityResp
- OpenAPIRefundChangeAvailabilityPassenger
- OpenAPIAskChangeDetail
- OpenAPIAskRefundDetail
- OpenAPIChangeSearchResp
- OpenAPIChangeSolutionResp
- OpenAPIChangePriceDetail
- OpenAPIChangePrice
- OpenAPIRefundMoneySearchResp
- OpenAPIBaggageTransitLeg
- OpenAPIBaggageTransitSegmentInfo
- TicketStatusResp
- TicketStatusItem
- TicketCouponStatus
- BalanceResp
- TrainApiResponseBase
- TrainErrorResponse
- TrainConnectionRegion
- TrainPriceBasis
- TrainOrderStatus
- TrainTicketStatus
- TrainTicketType
- TrainPassengerAttribute
- LocalizedName
- TrainShoppingLocation
- TrainShoppingRequest
- TrainStationWithDateTime
- TrainCarrier
- TrainShoppingFeature
- TrainPassengerTypeInfo
- TrainSeatInfo
- TrainShoppingSegment
- TrainShoppingJourney
- TrainShoppingData
- TrainPrice
- TrainAvailabilityRequest
- TrainAvailabilityData
- TrainBookingRequirementsData
- TrainSeatPreference
- TrainOrderContactRequest
- TrainOrderContact
- TrainPassengerRequest
- Train12306Account
- TrainCreateOrderRequest
- TrainCreateChangeRequest
- TrainCreateRefundRequest
- TrainChangeEstimateRequest
- TrainRefundEstimateRequest
- TrainPassenger
- TrainOrderSegment
- TrainOrderTicket
- TrainOrderJourney
- TrainOrder
- TrainConditionFee
- TrainCondition
- TrainOrderConditions
- TrainRefundEstimateItem
- TrainRefundEstimateData
- TrainChangeEstimateItem
- TrainChangeEstimateData
- TrainStopStation
- Train12306AccountRequest
- Train12306Contact
- Train12306PayFormRequest
- Train12306PayFormData
- Train12306LoginRequest
- Train12306PassengerInfo
- Train12306LoginData
- Train12306SendSmsRequest
- Train12306SmsVerifyRequest
- Train12306SmsSendData
- Train12306OperationData
- Train12306PassengerDto
- Train12306EditPassengerRequest
- Train12306FaceImage
- Train12306FaceVideo
- Train12306FaceVerifyRequest
- Train12306ForeignPassportRequest
- Train12306PassportProcessRequest
- Train12306PassportCheckData
- TrainStationInfo
- TrainCityInfo
- TrainStationSearchCity
- TrainStationSearchData
- TrainCitiesStationsData
- TrainOrderTicketFile
- TrainSyncRequest
- TrainSyncCity
- TrainSyncStation
- TrainSyncCitiesData
- TrainSyncStationsData
- TrainShoppingApiResponse
- TrainAvailabilityApiResponse
- TrainBookingRequirementsApiResponse
- TrainOrderApiResponse
- TrainStopStationsApiResponse
- TrainConditionsApiResponse
- TrainChangeEstimateApiResponse
- TrainRefundEstimateApiResponse
- TrainEmptyApiResponse
- Train12306ContactsApiResponse
- Train12306PayFormApiResponse
- Train12306LoginApiResponse
- Train12306SmsSendApiResponse
- Train12306SmsVerifyApiResponse
- Train12306OperationApiResponse
- Train12306PassportCheckApiResponse
- TrainSyncCitiesApiResponse
- TrainSyncStationsApiResponse
- TrainTicketsApiResponse
- TrainStationSearchApiResponse
- TrainCitiesStationsApiResponse
- TrainExchangeRatesApiResponse
- ShoppingApiResponse
- PricingApiResponse
- VerificationApiResponse
- FareRulesApiResponse
- OrderApiResponse
- OrderListApiResponse
- RefundChangeAvailabilityApiResponse
- ChangeSearchApiResponse
- RefundMoneySearchApiResponse
- BaggageTransitApiResponse
- TicketStatusApiResponse
- BalanceApiResponse
查询火车票
POST
https://apiv1.simplifly.tech/train/openapi/v4/shopping
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
Header Params
Body Params application/jsonRequired
Example
{
"changeForOrderId": "TO202607150001",
"departure": {
"cityId": "CNBJS",
"stationCodes": [
"BJP"
]
},
"arrival": {
"cityId": "CNBJS",
"stationCodes": [
"BJP"
]
},
"departureDate": "2026-07-20",
"departureStartTime": "08:00",
"departureEndTime": "18:00",
"returnDate": "2026-07-25",
"returnStartTime": "09:00",
"returnEndTime": "20:00",
"locale": "zh-Hans",
"connectionRegion": "EUROPE"
}Request Code Samples
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://apiv1.simplifly.tech/train/openapi/v4/shopping' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"changeForOrderId": "TO202607150001",
"departure": {
"cityId": "CNBJS",
"stationCodes": [
"BJP"
]
},
"arrival": {
"cityId": "CNBJS",
"stationCodes": [
"BJP"
]
},
"departureDate": "2026-07-20",
"departureStartTime": "08:00",
"departureEndTime": "18:00",
"returnDate": "2026-07-25",
"returnStartTime": "09:00",
"returnEndTime": "20:00",
"locale": "zh-Hans",
"connectionRegion": "EUROPE"
}'Responses
🟢200
application/json
Bodyapplication/json
Example
{
"code": 0,
"message": "Success",
"data": {
"currency": "CNY",
"connection_region": "EUROPE",
"journeys": [
{
"departure": {
"date": "2026-07-20",
"time": "09:00",
"stationCode": "BJP",
"stationName": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"arrival": {
"date": "2026-07-20",
"time": "09:00",
"stationCode": "BJP",
"stationName": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"arrivalDays": 0,
"duration": "PT4H28M",
"estimateIssueTime": "2026-07-18 12:00:00",
"seats": [
{
"seatId": "erdengzuo",
"displayName": "二等座",
"availability": 8,
"currency": "CNY",
"price": 553,
"originalPrice": 553,
"childPrice": 276.5,
"childOriginalPrice": 276.5,
"serviceFee": 20,
"features": [
"WIFI",
"REFU"
]
}
],
"marketingCarrier": {
"code": "CNRW",
"name": {
"en": "Beijing South",
"zh-Hans": "北京南"
},
"apiRefundAble": true
},
"convenienceFees": 20,
"segments": [
{
"id": "segment_0",
"tripCode": "G1",
"tripType": "High speed G",
"departure": {
"date": "2026-07-20",
"time": "09:00",
"stationCode": "BJP",
"stationName": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"arrival": {
"date": "2026-07-20",
"time": "09:00",
"stationCode": "BJP",
"stationName": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"arrivalDays": 0,
"duration": "PT4H28M",
"seats": [
{
"seatId": "erdengzuo",
"displayName": "二等座",
"availability": 8,
"currency": "CNY",
"price": 553,
"originalPrice": 553,
"childPrice": 276.5,
"childOriginalPrice": 276.5,
"serviceFee": 20,
"features": [
"WIFI",
"REFU"
]
}
],
"convenienceFees": 0
}
],
"id": "train_journey_G1_20260720",
"enableGrab": false
}
],
"returnJourneys": [
{
"departure": {
"date": "2026-07-20",
"time": "09:00",
"stationCode": "BJP",
"stationName": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"arrival": {
"date": "2026-07-20",
"time": "09:00",
"stationCode": "BJP",
"stationName": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"arrivalDays": 0,
"duration": "PT4H28M",
"estimateIssueTime": "2026-07-18 12:00:00",
"seats": [
{
"seatId": "erdengzuo",
"displayName": "二等座",
"availability": 8,
"currency": "CNY",
"price": 553,
"originalPrice": 553,
"childPrice": 276.5,
"childOriginalPrice": 276.5,
"serviceFee": 20,
"features": [
"WIFI",
"REFU"
]
}
],
"marketingCarrier": {
"code": "CNRW",
"name": {
"en": "Beijing South",
"zh-Hans": "北京南"
},
"apiRefundAble": true
},
"convenienceFees": 20,
"segments": [
{
"id": "segment_0",
"tripCode": "G1",
"tripType": "High speed G",
"departure": {
"date": "2026-07-20",
"time": "09:00",
"stationCode": "BJP",
"stationName": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"arrival": {
"date": "2026-07-20",
"time": "09:00",
"stationCode": "BJP",
"stationName": {
"en": "Beijing South",
"zh-Hans": "北京南"
}
},
"arrivalDays": 0,
"duration": "PT4H28M",
"seats": [
{
"seatId": "erdengzuo",
"displayName": "二等座",
"availability": 8,
"currency": "CNY",
"price": 553,
"originalPrice": 553,
"childPrice": 276.5,
"childOriginalPrice": 276.5,
"serviceFee": 20,
"features": [
"WIFI",
"REFU"
]
}
],
"convenienceFees": 0
}
],
"id": "train_journey_G1_20260720",
"enableGrab": false
}
],
"id": "train_shop_01J2X9D8Q1",
"supplierShoppingId": "supplier_shop_98321",
"enableGrab": false,
"providerId": 12,
"providerType": "jingxing",
"carriers_passenger_types": {
"property1": [
{
"code": "adult",
"name": "成人",
"ageMax": 59,
"ageMin": 14,
"description": "14 周岁及以上"
}
],
"property2": [
{
"code": "adult",
"name": "成人",
"ageMax": 59,
"ageMin": 14,
"description": "14 周岁及以上"
}
]
},
"features": {
"property1": {
"code": "WIFI",
"name": "Wi-Fi",
"description": "车内提供无线网络"
},
"property2": {
"code": "WIFI",
"name": "Wi-Fi",
"description": "车内提供无线网络"
}
}
}
}🟢200TrainBusinessError