POST/v1/flights/offers/:gdsprovider
API 控制台
试一试
向沙箱 API 发送真实请求并查看响应。
凭证
登录后即可从已保存的 API 密钥中选择，无需手动粘贴。
路径参数
1 个字段GDS 提供方
用于获取航班内容的全球分销系统。选择 0 使用默认提供方。
请求体
cURL 请求
bash
curl -X POST 'https://api.sandbox.travelandz.com/v1/flights/offers/0' \
-H 'Authorization: Bearer YOUR_SECRET_KEY' \
-H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE' \
-H 'Content-Type: application/json' \
-d '{"slices":[{"origin":"MAD","destination":"BCN","departure_date":"2026-08-20"}],"passengers":[{"type":"adult"}],"cabin_class":"economy","currency":"EUR","language":"es"}'请填写凭证以发送请求。
响应
点击「试一试！」发送请求，响应将显示在此处。
当集成必须明确指定单一 gdsprovider 时，搜索指定来源的航班报价。
接口
| 方法 | 路径 | 认证 |
|---|---|---|
POST | /v1/flights/offers/:gdsprovider | 需要 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. |
请求参数结构
gdsproviderAccepted values:
0, 1请求体结构
slicesslices[]originIATA code of the origin airport or city
slices[]destinationIATA code of the destination airport or city
slices[]departure_dateMust not be in the past
passengerspassengers[]typecabin_classcurrencyDefault EUR
languageOptional language for translated metadata when available
成功响应
返回 offers[] from the selected provider.
响应体结构
offersoffers[]offerIdoffers[]gdsprovideroffers[]expiresAtoffers[]totalAmountoffers[]holdOptionsoffers[]holdOptionsavailableoffers[]holdOptionspaymentRequiredByoffers[]holdOptionspriceGuarantedUntiloffers[]supportedPassengerIdDocumentsoffers[]supportedPassengerIdDocuments[]offers[]passengerIdentityDocumentsRequiredoffers[]supportedLoyaltyProgramsoffers[]supportedLoyaltyPrograms[]offers[]airlineoffers[]airlinenameoffers[]airlineiataCodeoffers[]airlinelogoURLoffers[]airlineconditionsOfCarriageoffers[]passengersoffers[]passengers[]idPublic passenger id to reuse during booking. Mystifly public offers generate internal ids such as
mystifly_pax_1.offers[]passengers[]typeoffers[]conditionsoffers[]conditionsrefundBeforeDepartureoffers[]conditionsrefundBeforeDeparturecurrencyoffers[]conditionsrefundBeforeDeparturepenaltyAmountoffers[]conditionsrefundBeforeDepartureallowedoffers[]conditionschangeBeforeDepartureoffers[]conditionschangeBeforeDeparturecurrencyoffers[]conditionschangeBeforeDeparturepenaltyAmountoffers[]conditionschangeBeforeDepartureallowedoffers[]slicesoffers[]slices[]fareNameoffers[]slices[]departureoffers[]slices[]departureiataCodeoffers[]slices[]departurecityNameoffers[]slices[]departureairportNameoffers[]slices[]departuredepartingAtoffers[]slices[]departuretimeZoneoffers[]slices[]arrivaloffers[]slices[]arrivaliataCodeoffers[]slices[]arrivalcityNameoffers[]slices[]arrivalairportNameoffers[]slices[]arrivalarrivingAtoffers[]slices[]arrivaltimeZoneoffers[]slices[]durationMinutesoffers[]slices[]conditionsoffers[]slices[]conditionspriorityCheckInoffers[]slices[]conditionspriorityBoardingoffers[]slices[]conditionsadvanceSeatSelectionoffers[]slices[]segmentsoffers[]slices[]segments[]fareNameoffers[]slices[]segments[]departureoffers[]slices[]segments[]departureiataCodeoffers[]slices[]segments[]departurecityNameoffers[]slices[]segments[]departureairportNameoffers[]slices[]segments[]departuredepartingAtoffers[]slices[]segments[]departuretimeZoneoffers[]slices[]segments[]departureterminaloffers[]slices[]segments[]arrivaloffers[]slices[]segments[]arrivaliataCodeoffers[]slices[]segments[]arrivalcityNameoffers[]slices[]segments[]arrivalairportNameoffers[]slices[]segments[]arrivalarrivingAtoffers[]slices[]segments[]arrivaltimeZoneoffers[]slices[]segments[]arrivalterminaloffers[]slices[]segments[]airlineoffers[]slices[]segments[]airlineoperatingCarrieroffers[]slices[]segments[]airlineoperatingCarriernameoffers[]slices[]segments[]airlineoperatingCarrieriataCodeoffers[]slices[]segments[]airlineoperatingCarrierlogoURLoffers[]slices[]segments[]airlineoperatingCarrierconditionsOfCarriageoffers[]slices[]segments[]airlinemarketingCarrieroffers[]slices[]segments[]airlinemarketingCarriernameoffers[]slices[]segments[]airlinemarketingCarrieriataCodeoffers[]slices[]segments[]airlinemarketingCarrierlogoURLoffers[]slices[]segments[]airlinemarketingCarrierconditionsOfCarriageoffers[]slices[]segments[]flightNumberoffers[]slices[]segments[]durationMinutesoffers[]slices[]segments[]passengersoffers[]slices[]segments[]passengers[]amenitiesoffers[]slices[]segments[]passengers[]amenitieswifioffers[]slices[]segments[]passengers[]amenitieswificostoffers[]slices[]segments[]passengers[]amenitieswifiavailableoffers[]slices[]segments[]passengers[]amenitiesseatoffers[]slices[]segments[]passengers[]amenitiesseatpitchoffers[]slices[]segments[]passengers[]amenitiesseatlegroomoffers[]slices[]segments[]passengers[]amenitiesseattypeoffers[]slices[]segments[]passengers[]amenitiespoweroffers[]slices[]segments[]passengers[]baggagesoffers[]slices[]segments[]passengers[]baggages[]typeoffers[]slices[]segments[]passengers[]baggages[]quantityoffers[]slices[]segments[]passengers[]baggages[]maxKgoffers[]CO2EmissionsKgoffers[]holdIdoffers[]originalCurrencyoffers[]currencyliveModeTrue when the request is served by the live Travelandz environment. This value comes from Travelandz, not the provider payload.
集成说明
Use this endpoint only when the integration must force a provider. The response shape matches the public flight search response.
示例
bash
curl -X POST https://api.sandbox.travelandz.com/v1/flights/offers/0 \
-H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
-H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE" \
-H "Content-Type: application/json" \
-d '{"slices":[{"origin":"MAD","destination":"BCN","departure_date":"2026-08-20"}],"passengers":[{"type":"adult"}],"cabin_class":"economy","currency":"EUR"}'