搜索两个地点之间指定日期的火车行程。
认证和请求头
| 请求头 | 说明 |
|---|---|
Authorization | Bearer <secret_key>。密钥只能保存在服务器端，不能写入客户端日志。 |
X-Travelandz-Id | <public_key>:<profile_code>，持久化的 profile code 格式为 dp_<12 位字母数字>。 |
Content-Type | 带 JSON body 的请求使用 application/json。 |
请求
必需的 JSON body：
json
{
"origin": "originId",
"destination": "destinationId",
"date": "2026-08-20",
"passengers": [{ "type": "adult" }]
}origin 和 destination 是地点 id。date 使用 YYYY-MM-DD。passengers 至少包含一项，type 可为 youth、adult 或 senior。
请求体结构
originLocation id returned by
/locations.destinationLocation id returned by
/locations.datepassengerspassengers[]typeyouth = 0–27 years, adult = 28–59 years, senior = 60+ years.成功响应
返回 journeys[]。每个行程包含 gdsprovider、journeyId、行程、区段、中途停留、路线、舒适等级、住宿和票务等级。区段时间使用 ISO 8601。
响应体结构
journeysjourneys[]gdsproviderjourneys[]journeyIdjourneys[]itineraryjourneys[]itinerary[]itineraryIndexjourneys[]itinerary[]segmentsjourneys[]itinerary[]segments[]segmentIdjourneys[]itinerary[]segments[]departurejourneys[]itinerary[]segments[]departuredepartureAtjourneys[]itinerary[]segments[]departurenamejourneys[]itinerary[]segments[]departurelocationIdjourneys[]itinerary[]segments[]departurecountryjourneys[]itinerary[]segments[]departurecountryCodejourneys[]itinerary[]segments[]arrivaljourneys[]itinerary[]segments[]arrivalarrivalAtjourneys[]itinerary[]segments[]arrivalnamejourneys[]itinerary[]segments[]arrivallocationIdjourneys[]itinerary[]segments[]arrivalcountryjourneys[]itinerary[]segments[]arrivalcountryCodejourneys[]itinerary[]segments[]identifierjourneys[]itinerary[]segments[]transportjourneys[]itinerary[]segments[]durationInMinutesjourneys[]itinerary[]segments[]operatorjourneys[]itinerary[]segments[]operatorcodejourneys[]itinerary[]segments[]operatornamejourneys[]itinerary[]segments[]operatorimageUrljourneys[]itinerary[]segments[]servicejourneys[]itinerary[]segments[]servicenamejourneys[]itinerary[]segments[]serviceimageUrljourneys[]stopoversjourneys[]stopovers[]stopoverIndexjourneys[]stopovers[]durationInMinutesjourneys[]routejourneys[]route[]itineraryIndexjourneys[]route[]stopoverIndexjourneys[]comfortClassesjourneys[]comfortClasses[]journeys[]accommodationsjourneys[]accommodations[]journeys[]ticketClassesjourneys[]ticketClasses[]comfortClassjourneys[]ticketClasses[]serviceClass错误
400表示验证失败或存在未知字段。401或403表示 API 凭证无效。- 供应方失败时返回
500 internal_communication_error或unknown_error。 - 没有可用行程时返回
404 zero_journeys_found。
使用说明
保存 journeyId 以请求报价。operator.imageUrl 和 service.imageUrl 可能为 null。
cURL 示例
bash
curl --request POST \
--url "https://api.sandbox.travelandz.com/v1/trains/journeys" \
--header "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
--header "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
--header "Content-Type: application/json" \
--data '{"origin":"originId","destination":"destinationId","date":"2026-08-20","passengers":[{"type":"adult"}]}'