GETflight-query
飞机航班信息查询
通过出发地、目的地、出发日期等信息查询航班信息。
接入文档
接口简介
本接口支持通过出发地、目的地和出发日期，查询国内及国际航班的详细行程信息。返回数据包含航空公司代码、航班号、起降机场三字码、具体起降时间、飞行时长、中转次数以及参考票价。
适用场景
- 差旅管理系统：为企业员工提供实时的航班时刻检索与比价功能。
- OTA 平台集成：补充航班基础数据，展示直飞或中转方案及预计耗时。
- 行程规划应用：帮助用户根据起降时间和机场信息制定出行计划。
请求与返回说明
- 请求方式：GET
- 核心参数：需传入出发地、目的地及出发日期。
- 返回结构：
flightInfo：航班列表数组。airline/airlineName：航司二字码及中文名称。departure/arrival：起降机场三字码（如 PEK, PVG）。departureTime/arrivalTime：计划起降时间。transferNum：中转次数，0 表示直飞。ticketPrice：参考票价（数值类型）。segments：若为中转航班，包含各航段的详细执飞信息。
接入建议
- 缓存策略：航班时刻表相对稳定，建议对同一航线同一日期的查询结果进行短期缓存，以减少 API 调用成本。
- 价格说明：接口返回的
ticketPrice仅为参考价格，实际交易价格请以航司或代理商实时出票为准。 - 异常处理：请检查返回中的
reason字段，确保在查询无结果或参数错误时给予用户友好提示。
接入示例代码
提供 Shell、Python、Go、Java、PHP 等常见接入示例，便于直接接到现有项目里。
请求示例
{}响应示例
{
"reason": "成功",
"result": {
"orderid": "JH818250617094826CZLKl",
"flightInfo": [
{
"airline": "CA",
"airlineName": "中国**航空公司",
"flightNo": "CA0953 | CA0916",
"isCodeShare": false,
"departure": "PEK",
"departureName": "首都国际机场",
"departureDate": "2025-06-18",
"departureTime": "09:05",
"arrivalDate": "2025-06-18",
"arrivalTime": "17:05",
"arrival": "PVG",
"arrivalName": "浦东国际机场",
"duration": "08h00m",
"transferNum": 2,
"ticketPrice": 15063,
"segments": [
{
"airline": "CA",
"flightNo": "CA0953",
"isCodeShare": false,
"opAirline": "CA",
"opFlightNo": "CA0953",
"equipment": "738",
"departure": "PEK",
"departureDate": "2025-06-18",
"departureTime": "09:05",
"arrival": "FUK",
"arrivalDate": "2025-06-18",
"arrivalTime": "14:10",
"flightTime": "04h05m",
"airlineName": "中国**航空公司",
"departureName": "首都国际机场",
"arrivalName": "福冈机场"
},
{
"airline": "CA",
"flightNo": "CA0916",
"isCodeShare": false,
"opAirline": "CA",
"opFlightNo": "CA0916",
"equipment": "321",
"departure": "FUK",
"departureDate": "2025-06-18",
"departureTime": "15:55",
"arrival": "PVG",
"arrivalDate": "2025-06-18",
"arrivalTime": "17:05",
"flightTime": "02h10m",
"airlineName": "中国**航空公司",
"departureName": "福冈机场",
"arrivalName": "浦东国际机场"
}
]
}
]
},
"error_code": 0
}请求字段
以下字段根据示例 JSON 自动提取，仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
响应字段
以下字段根据示例 JSON 自动提取，仅作接入参考。
| 字段路径 | 类型 | 示例值 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.reason | object | {...} |
| properties.reason.type | string | string |
| properties.reason.example | string | 成功 |
| properties.result | object | {...} |
| properties.result.type | string | object |
