GET/v1/flights/booking/:gdsprovider/:orderId
API 控制台
试一试
向沙箱 API 发送真实请求并查看响应。
凭证
登录后即可从已保存的 API 密钥中选择，无需手动粘贴。
路径参数
2 个字段GDS 提供方
用于获取航班内容的全球分销系统。选择 0 使用默认提供方。
Order ID
创建预订时返回的订单标识符。
cURL 请求
bash
curl -X GET 'https://api.sandbox.travelandz.com/v1/flights/booking/0/:orderId' \
-H 'Authorization: Bearer YOUR_SECRET_KEY' \
-H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE'请填写凭证以发送请求。
响应
点击「试一试！」发送请求，响应将显示在此处。
读取通过 Travelandz 创建的航班订单的当前状态和标准化详情。
接口
| 方法 | 路径 | 认证 |
|---|---|---|
GET | /v1/flights/booking/:gdsprovider/:orderId | 需要 API key |
| Header | 说明 |
|---|---|
Authorization | Bearer <secret_key>. The secret is shown only once when the credential is created. |
X-Travelandz-Id | <public_key>:<profile_code>. The profile_code is the dp_-prefixed Developer Profile code shown in your dashboard. This binds the request to a profile and credential. |
Content-Type | Use application/json for requests with a body. |
请求参数结构
gdsproviderorderId请求体
不需要请求体。
成功响应
返回 details of the order
响应体结构
orderDetailsorderDetailsorderIdorderDetailsgdsproviderorderDetailsbookingReferenceorderDetailsconditionsorderDetailsconditionsrefundBeforeDepartureorderDetailsconditionsrefundBeforeDeparturecurrencyorderDetailsconditionsrefundBeforeDeparturepenaltyAmountorderDetailsconditionsrefundBeforeDepartureallowedorderDetailsconditionschangeBeforeDepartureorderDetailsconditionschangeBeforeDeparturecurrencyorderDetailsconditionschangeBeforeDeparturepenaltyAmountorderDetailsconditionschangeBeforeDepartureallowedorderDetailssyncedAtorderDetailsslicesorderDetailsslices[]fareNameorderDetailsslices[]departureorderDetailsslices[]departureiataCodeorderDetailsslices[]departurecityNameorderDetailsslices[]departureairportNameorderDetailsslices[]departuredepartingAtorderDetailsslices[]departuretimeZoneorderDetailsslices[]arrivalorderDetailsslices[]arrivaliataCodeorderDetailsslices[]arrivalcityNameorderDetailsslices[]arrivalairportNameorderDetailsslices[]arrivaldepartingAtorderDetailsslices[]arrivaltimeZoneorderDetailsslices[]segmentsorderDetailsslices[]segments[]fareNameorderDetailsslices[]segments[]departureorderDetailsslices[]segments[]departureiataCodeorderDetailsslices[]segments[]departurecityNameorderDetailsslices[]segments[]departureairportNameorderDetailsslices[]segments[]departuredepartingAtorderDetailsslices[]segments[]departuretimeZoneorderDetailsslices[]segments[]departureterminalorderDetailsslices[]segments[]arrivalorderDetailsslices[]segments[]arrivaliataCodeorderDetailsslices[]segments[]arrivalcityNameorderDetailsslices[]segments[]arrivalairportNameorderDetailsslices[]segments[]arrivaldepartingAtorderDetailsslices[]segments[]arrivaltimeZoneorderDetailsslices[]segments[]arrivalterminalorderDetailsslices[]segments[]airlineorderDetailsslices[]segments[]airlineoperatingCarrierorderDetailsslices[]segments[]airlineoperatingCarriernameorderDetailsslices[]segments[]airlineoperatingCarrieriataCodeorderDetailsslices[]segments[]airlineoperatingCarrierlogoURLorderDetailsslices[]segments[]airlineoperatingCarrierconditionsOfCarriageorderDetailsslices[]segments[]airlinemarketingCarrierorderDetailsslices[]segments[]airlinemarketingCarriernameorderDetailsslices[]segments[]airlinemarketingCarrieriataCodeorderDetailsslices[]segments[]airlinemarketingCarrierlogoURLorderDetailsslices[]segments[]airlinemarketingCarrierconditionsOfCarriageorderDetailsslices[]segments[]flightNumberorderDetailsslices[]segments[]durationMinutesorderDetailspassengersorderDetailspassengers[]typeorderDetailspassengers[]titleorderDetailspassengers[]phoneNumberorderDetailspassengers[]infantPassengerIdorderDetailspassengers[]idorderDetailspassengers[]firstNameorderDetailspassengers[]genderorderDetailspassengers[]lastNameorderDetailspassengers[]emailorderDetailspassengers[]bornOnorderDetailspassengers[]ticketsorderDetailspassengers[]tickets[]ticketNumberorderDetailspassengers[]tickets[]statusorderDetailspassengers[]tickets[]typeET, EMD-A, EMD-S
orderDetailsdocumentsorderDetailsdocuments[]passengerIdsorderDetailsdocuments[]passengerIds[]orderDetailsdocuments[]typeorderDetailsdocuments[]idorderDetailsbookingReferencesorderDetailsbookingReferences[]referenceorderDetailsbookingReferences[]airlineorderDetailsbookingReferences[]airlineoperatingCarrierorderDetailsbookingReferences[]airlineoperatingCarriernameorderDetailsbookingReferences[]airlineoperatingCarrieriataCodeorderDetailsbookingReferences[]airlineoperatingCarrierlogoURLorderDetailsbookingReferences[]airlineoperatingCarrierconditionsOfCarriageorderDetailsbookingReferences[]airlinemarketingCarrierorderDetailsbookingReferences[]airlinemarketingCarriernameorderDetailsbookingReferences[]airlinemarketingCarrieriataCodeorderDetailsbookingReferences[]airlinemarketingCarrierlogoURLorderDetailsbookingReferences[]airlinemarketingCarrierconditionsOfCarriageorderDetailstotalAmountorderDetailsofferIdliveModeTrue when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.
集成说明
- The response detail can vary by source.
- Some booking responses can return passengers and tickets without flight slices. When the order was created after a public search, Travelandz enriches
slices,conditionsandofferIdfrom the tracked parsed offer. - If no tracked offer snapshot exists, the endpoint returns the available provider detail without failing only because slices are missing.
示例
bash
curl https://api.sandbox.travelandz.com/v1/flights/booking/1/order_123 \
-H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
-H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"响应
| 状态码 | 说明 |
|---|---|
200 | Flight booking detail retrieved successfully. |
400 | 请求无效：payload 不合法。 |
401 | 未授权：凭证无效或缺失。 |
403 | 禁止访问：凭证无效。 |
500 | 服务器内部错误 |
200 响应体
媒体类型：application/json
json
{
"orderDetails": {
"orderId": "ord_0000B7aw6DtypHDaOdA5hV",
"gdsprovider": 0,
"bookingReference": "YIYLIU",
"conditions": {
"refundBeforeDeparture": {
"currency": "EUR",
"penaltyAmount": "40.00",
"allowed": true
},
"changeBeforeDeparture": {
"currency": null,
"penaltyAmount": null,
"allowed": false
}
},
"syncedAt": "2026-06-22T14:59:40.000Z",
"slices": [
{
"fareName": "Basic",
"departure": {
"iataCode": "MAD",
"cityName": "Madrid",
"airportName": "Adolfo Suarez Madrid-Barajas Airport",
"departingAt": "2026-08-12T08:30:00",
"timeZone": "Europe/Madrid"
},
"arrival": {
"iataCode": "JFK",
"cityName": "New York",
"airportName": "John F. Kennedy International Airport",
"arrivingAt": "2026-08-12T10:45:00",
"timeZone": "America/New_York"
},
"durationMinutes": 495,
"segments": [
{
"fareName": "Basic",
"departure": {
"iataCode": "MAD",
"cityName": "Madrid",
"airportName": "Adolfo Suarez Madrid-Barajas Airport",
"departingAt": "2026-08-12T08:30:00",
"timeZone": "Europe/Madrid"
},
"arrival": {
"iataCode": "JFK",
"cityName": "New York",
"airportName": "John F. Kennedy International Airport",
"arrivingAt": "2026-08-12T10:45:00",
"timeZone": "America/New_York"
},
"airline": {
"operatingCarrier": {
"name": "Duffel Airways",
"iataCode": "ZZ",
"logoURL": "http://localhost:5000/v1/assets/airlines/0/for-light-background/full-color-logo/ZZ.svg",
"conditionsOfCarriage": "https://duffelairways.com/dummy-url/conditions-of-carriage"
},
"marketingCarrier": {
"name": "Duffel Airways",
"iataCode": "ZZ",
"logoURL": "http://localhost:5000/v1/assets/airlines/0/for-light-background/full-color-logo/ZZ.svg",
"conditionsOfCarriage": "https://duffelairways.com/dummy-url/conditions-of-carriage"
}
},
"flightNumber": "6652",
"durationMinutes": 495
}
]
}
],
"passengers": [
{
"type": "adult",
"title": "mr",
"phoneNumber": "+573128837058",
"infantPassengerId": null,
"id": "pas_0000B7avhgfVejj9UCTZhq",
"gender": "m",
"firstName": "Alejandro",
"lastName": "Toledo",
"email": "jairotoledo2003@gmail.com",
"bornOn": "2003-08-14",
"tickets": [
{
"ticketNumber": "1",
"status": "ticketed",
"type": "Electronic"
}
]
}
],
"documents": [
{
"passengerIds": [
"pas_0000B7avhgfVejj9UCTZhq"
],
"type": "electronic_ticket",
"id": "1"
}
],
"bookingReferences": [
{
"reference": "YIYLIU",
"airline": {
"name": "Duffel Airways",
"iataCode": "ZZ",
"logoURL": "https://assets.duffel.com/img/airlines/for-light-background/full-color-logo/ZZ.svg",
"conditionsOfCarriage": "https://duffelairways.com/dummy-url/conditions-of-carriage"
}
}
],
"totalAmount": 221.89,
"offerId": "off_0000B7avhgxqQpXBVp2r7H"
},
"liveMode": false
}