加载接口文档…
1
累计调用
3ms
平均响应
100.00%
服务可用性
本接口不提供公共免费额度。请按会员或按次计费。
未携带 API Key
无匿名额度，须携带 API Key
登录免费
无登录免费额度 · QPS 5
黄金会员
本档不提供 VIP 额度 · QPS 10
钻石会员
本档不提供 VIP 额度 · QPS 20
企业会员
本档不提供 VIP 额度 · QPS 30
必须携带 API Key。无免费额度。查到航班按次 0.330 元；未查到、参数不正确或本次未能完成查询时不计费。登录QPS 5，黄金会员 10 次，钻石会员 20 次，企业会员 30 次。
必填 · 出发地。IATA 城市码或机场码，3 位字母。例：北京 BJS，首都机场 PEK，大兴机场 PKX · 示例：BJS
必填 · 目的地。IATA 城市码或机场码，3 位字母。例：上海 SHA，浦东机场 PVG，虹桥机场 SHA · 示例：SHA
必填 · 出发日期，格式 yyyy-MM-dd · 示例：2026-11-02
可选 · 航班号，2 到 10 位字母或数字。填写时，出发地和目的地请填机场码 · 示例：HO1254
可选 · 航段上限。0 不限，1 仅直飞，2 最多一次中转，3 最多两次中转。不填视为不限 · 示例：1
| 名称 | 类型 | 说明 |
|---|---|---|
| departure | string | 必填 · 出发地。IATA 城市码或机场码，3 位字母。例：北京 BJS，首都机场 PEK，大兴机场 PKX · 示例：BJS |
| arrival | string | 必填 · 目的地。IATA 城市码或机场码，3 位字母。例：上海 SHA，浦东机场 PVG，虹桥机场 SHA · 示例：SHA |
| departure_date | string | 必填 · 出发日期，格式 yyyy-MM-dd · 示例：2026-11-02 |
| flight_no | string | 可选 · 航班号，2 到 10 位字母或数字。填写时，出发地和目的地请填机场码 · 示例：HO1254 |
| max_segments | int | 可选 · 航段上限。0 不限，1 仅直飞，2 最多一次中转，3 最多两次中转。不填视为不限 · 示例：1 |
必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。
| 名称 | 类型 | 说明 |
|---|---|---|
| Authorization | string | 必填 · 必填鉴权。推荐：Bearer <API Key>。兼容请求头 X-API-Key，以及 Query api_key / apikey / key（key 仅当值为 sk_live_/sk_test_/sk_stag_ 形态时生效）。付费接口需携带有效 Key。 |
本次查询的出发地代码
本次查询的目的地代码
出发日期
仅当请求填写了航班号时返回
仅当请求填写了航段上限时返回
本次返回的航班条数。示例只保留 1 条
航班列表。未查到时为空数组，且本次不计费
航空公司代码
航空公司名称
航班号。中转时可能包含多个航班号
是否包含共享航班
机型
出发机场码
出发机场名称
出发日期
出发时间
到达机场码
到达机场名称
到达日期
到达时间
航程时长，如 2h10m
航段数量。1 为直飞，大于 1 为中转
参考票价，单位元。没有则为 null
各航段。仅中转航班返回
该航段航空公司代码
该航段航空公司名称
该航段航班号
该航段是否为共享航班
该航段实际承运航空公司代码
该航段实际承运航班号
该航段机型
该航段出发机场码
该航段出发机场名称
该航段出发日期
该航段出发时间
该航段到达机场码
该航段到达机场名称
该航段到达日期
该航段到达时间
该航段飞行时长
品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn
| 名称 | 类型 | 说明 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| departure | string | 本次查询的出发地代码 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| arrival | string | 本次查询的目的地代码 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| departure_date | string | 出发日期 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| flight_no | string | 仅当请求填写了航班号时返回 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| max_segments | int | 仅当请求填写了航段上限时返回 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| count | int | 本次返回的航班条数。示例只保留 1 条 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| flights | array | 航班列表。未查到时为空数组，且本次不计费 | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
| tips | string | 品牌提示（所有接口统一返回）：极数本源 · https://apizero.cn | ||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||
{
"code": 0,
"msg": "成功",
"data": {
"departure": "PEK",
"arrival": "PVG",
"departure_date": "2025-06-18",
"count": 1,
"flights": [
{
"airline": "CA",
"airline_name": "中国国际航空公司",
"flight_no": "CA0953 | CA0916",
"is_code_share": false,
"equipment": "325",
"departure": "PEK",
"departure_name": "首都国际机场",
"departure_date": "2025-06-18",
"departure_time": "09:05",
"arrival": "PVG",
"arrival_name": "浦东国际机场",
"arrival_date": "2025-06-18",
"arrival_time": "17:05",
"duration": "08h00m",
"transfer_num": 2,
"ticket_price": 15063,
"segments": [
{
"airline": "CA",
"airline_name": "中国国际航空公司",
"flight_no": "CA0953",
"is_code_share": false,
"op_airline": "CA",
"op_flight_no": "CA0953",
"equipment": "738",
"departure": "PEK",
"departure_name": "首都国际机场",
"departure_date": "2025-06-18",
"departure_time": "09:05",
"arrival": "FUK",
"arrival_name": "福冈机场",
"arrival_date": "2025-06-18",
"arrival_time": "14:10",
"flight_time": "04h05m"
},
{
"airline": "CA",
"airline_name": "中国国际航空公司",
"flight_no": "CA0916",
"is_code_share": false,
"op_airline": "CA",
"op_flight_no": "CA0916",
"equipment": "321",
"departure": "FUK",
"departure_name": "福冈机场",
"departure_date": "2025-06-18",
"departure_time": "15:55",
"arrival": "PVG",
"arrival_name": "浦东国际机场",
"arrival_date": "2025-06-18",
"arrival_time": "17:05",
"flight_time": "02h10m"
}
]
}
]
},
"tips": "极数本源 · https://apizero.cn"
}航班时刻与参考票价仅供行程安排参考，不构成航班必将执行的承诺，也不构成可按该价格出票的承诺。
共享航班的实际承运航班可能与销售航班号不同。中转航班请同时核对各航段的起降时间。
调用本接口即表示已阅读并同意上述说明。