1. 查询与预订
STTS OPEN API
中文
  • English
  • 中文
  • Flight
    • 查询与报价
      • 航班查询
      • 航段报价
      • 全舱报价
      • 方案验价
      • 查询退改签和行李规则
    • 订单
      • 创建航班原始订单
      • 查询航班订单列表
      • 查询航班订单详情
      • 取消航班订单
      • 通过外部订单号查询航班订单
      • 支付航班订单
    • 退改签
      • 查询订单是否可退改
      • 航班改签搜索 / 查价
      • 创建航班改签单
      • 查询航班可退金额
      • 创建航班退票单
      • 确认航班退票单
      • 确认航班0元改签单
    • 服务与状态
      • 行李直挂 / 中转行李查询
      • 查询航班票号状态
      • 下载电子客票行程单
    • 账户
      • 查询航班账户余额
    • 回调通知
      • 航变回调
      • 订单通知
  • Train
    • 查询与预订
      • 查询火车票
        POST
      • 检查座位和价格
        POST
      • 查询预订必填项
        GET
      • 创建火车票订单
        POST
    • 订单
      • 查询火车票订单
      • 查询订单退改条件
      • 确认预售订单
      • 支付订单
      • 取消订单
    • 退改签
      • 预估改签费用
      • 预估退票费用
      • 申请改签
      • 申请退票
      • 确认改签
      • 确认退票
    • 车次与站点
      • 按订单查询经停车站
      • 按车次查询经停车站
      • 搜索城市和车站
      • 批量获取城市和车站
      • 查询汇率
    • 合作方同步
      • 增量同步城市
      • 增量同步车站
    • 12306
      • 获取 12306 常用联系人
      • 获取 12306 支付表单
      • 登录 12306
      • 发送 12306 短信验证码
      • 验证 12306 短信验证码
      • 编辑 12306 乘客
      • 执行 12306 人脸核验
      • 提交外籍护照核验
      • 查询外籍护照核验进度
    • 电子票
      • 下载 PDF 电子票
      • 获取 HTML 电子票
      • 按类型获取电子票
  • 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
  1. 查询与预订

查询预订必填项

GET
https://apiv1.simplifly.tech/train/openapi/v4/booking-requirements
返回指定查询方案下联系人和乘客需要填写的字段,以及支持的证件类型。实际下单时应按照本接口返回的字段补齐资料。

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
Query Params

Header Params

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/booking-requirements?shoppingId=train_shop_01J2X9D8Q1&journeyId=train_journey_G123_20260720' \
--header 'code: <api-key>' \
--header 'timestamp: <api-key>' \
--header 'signature: <api-key>'

Responses

🟢200
application/json
查询成功。
Bodyapplication/json

Example
{
    "code": 0,
    "message": "Success",
    "data": {
        "contactRequirements": [
            "name",
            "email"
        ],
        "passengerRequirements": [
            "givenNames",
            "passengerType",
            "travelDocumentType",
            "travelDocumentNumber"
        ],
        "supportTravelDocumentTypes": [
            "idcard",
            "passport"
        ]
    }
}
🟢200TrainBusinessError
Previous
检查座位和价格
Next
创建火车票订单
Built with