GET/v1/transfers/flights

搜索接送服务航班

查询旅客所乘的到达或出发航班。

分享
GET/v1/transfers/flights

API 控制台

试一试

向沙箱 API 发送真实请求并查看响应。

凭证

登录后即可从已保存的 API 密钥中选择，无需手动粘贴。

查询参数

7 个字段

航空公司代码

两位 IATA 航空公司代码，例如 W6。

机场代码

三位 IATA 机场代码，例如 BCN。

航班方向

旅客是抵达该机场还是从该机场出发。

接客日期和时间

当地接客日期和时间，例如 2026-06-30 10:45。

航班号

不含航空公司代码的航班号。

货币

返回金额所用的货币。若已存在报价或预订，必须与其保持一致。

语言

旧版语言字段。建议使用 LANG 或 Accept-Language 请求头。

cURL 请求

cURL
bash
curl -X GET 'https://api.sandbox.travelandz.com/v1/transfers/flights?airlineCode=W6&airportCode=BCN&flightDirection=arriving&pickupDatetime=2026-06-30+10%3A45&flightNumber=1705&currency=USD' \
  -H 'Authorization: Bearer YOUR_SECRET_KEY' \
  -H 'X-Travelandz-Id: YOUR_PUBLIC_KEY:YOUR_PROFILE_CODE'

请填写凭证以发送请求。

响应

点击「试一试！」发送请求，响应将显示在此处。

查询旅客所乘的到达或出发航班。

认证和请求头

请求头说明
AuthorizationBearer <secret_key>。密钥只能保存在服务器端，不能写入客户端日志。
X-Travelandz-Id<public_key>:<profile_code>，持久化的 profile code 格式为 dp_<12 位字母数字>。
LANG推荐的语言请求头，也支持 Accept-Language。
Content-Type带 JSON body 的请求使用 application/json。

请求

此端点不接收请求体。五个用于识别航班的查询参数均为必需。

请求查询参数模式

airlineCode
string
格式: IATA (2 characters)
是
airportCode
string
格式: IATA (3 characters)
是
flightDirection
enum
arrivingdepartingarrdep
是
pickupDatetime
string是
flightNumber
string是
currency
enum
EURUSDINRCHFJPYGBPAUDCADCNYSGDNZDMXN
否
Lowercase values are accepted and normalized. Defaults to USD on a new search and is inherited afterwards.
language
enum
en-USes-ESde-DEfr-FRpt-BRzh-CNit-IT
否
Legacy field. Prefer the LANG or Accept-Language header.

成功响应

返回 flights[]。空数组是成功结果，仅表示没有匹配的航班。

响应体结构

flights
array是
flights[]airlineCode
string是
flights[]airlineName
string否
flights[]flightNumber
string是
flights[]flightCode
string否
Airline code and flight number combined.
flights[]flightType
enum
domesticinternational
否
flights[]origin
string
格式: IATA (3 characters)
否
flights[]destination
string
格式: IATA (3 characters)
否
flights[]time
string否
Localized display time.
flights[]datetime
string
格式: ISO 8601
否

响应示例

json
json
{
  "flights": [
    {
      "airlineCode": "W6",
      "airlineName": "Wizz Air",
      "flightNumber": "1705",
      "flightCode": "W61705",
      "flightType": "international",
      "origin": "GDN",
      "destination": "BCN",
      "time": "9:10PM",
      "datetime": "2026-06-30T21:10:00+02:00"
    }
  ]
}

错误

HTTP代码含义建议操作
400请求体、查询参数或路径无效，或包含未知属性。根据 message 数组修正请求。
400transfer_invalid_currency该货币不在支持列表中。使用受支持的货币。
400transfer_invalid_language请求的语言不受支持。使用文档中列出的语言值之一。
429transfer_provider_error服务暂时被限流。使用指数退避重试。
502transfer_provider_error请求无法完成。不要假定成功。保留标识符，并在该操作可能已创建时查询预订。

使用说明

使用此端点为预订填充 airline 和 flightNumber，然后在向旅客收费前，针对接客时间验证该航班。

cURL 示例

bash
bash
curl --request GET \
  --url "https://api.sandbox.travelandz.com/v1/transfers/flights?airlineCode=W6&airportCode=BCN&flightDirection=arriving&pickupDatetime=2026-06-30%2010%3A45&flightNumber=1705&currency=USD" \
  -H "Authorization: Bearer $TRAVELANDZ_SECRET_KEY" \
  -H "X-Travelandz-Id: $TRAVELANDZ_PUBLIC_KEY:$TRAVELANDZ_PROFILE_CODE"