航班查询 - 聚合数据
生活服务需配置 API Key航班查询。通过出发地、目的地、出发日期查询航班信息，包括航班号、起飞时间、到达时间、机票价格等。使用场景：用户说"查一下北京到上海的航班"、"明天广州到北京的飞机"、"查询某日航班"、"机票价格查询"等。通过聚合数据（juhe.cn）API 实时查询，免费注册每天免费调用。
525
下载量
46
安装量
0
收藏量
★ 5.0
综合评分ⓘ
航班查询#
数据由 聚合数据 提供 — 国内领先的数据服务平台，提供天气、快递、身份证、手机号、IP 查询等 200+ 免费/低价 API。
通过出发地、目的地、出发日期查询 航班信息，包括航班号、起飞/到达时间、机票价格、中转信息等。
前置配置：获取 API Key#
bash
# 方式一：环境变量（推荐，一次配置永久生效）
export JUHE_FLIGHT_KEY=你的 AppKey
# 方式二：.env 文件（在脚本目录创建）
echo "JUHE_FLIGHT_KEY=你的 AppKey" > scripts/.env
# 方式三：每次命令行传入
python scripts/flight_query.py --key 你的 AppKey --departure BJS --arrival SHA --date 2025-06-18
免费额度：每天免费调用，具体次数以官网为准。
使用方法#
查询航班#
bash
# 北京到上海（使用机场三字代码）
python scripts/flight_query.py --departure BJS --arrival SHA --date 2025-06-18
# 广州到北京
python scripts/flight_query.py --departure CAN --arrival BJS --date 2025-06-18
输出示例：
text
✈️ 航班查询结果
出发地：北京首都国际机场 (BJS)
目的地：上海浦东国际机场 (PVG)
出发日期：2025-06-18
航班号：CA0953
航空公司：中国国际航空
起飞时间：09:05
到达时间：17:05
飞行时长：08h00m
中转次数：2
机票价格：¥15063
常用机场代码#
代码城市机场BJS北京首都国际机场SHA上海虹桥/浦东机场CAN广州白云国际机场SZX深圳宝安国际机场CTU成都双流国际机场KMG昆明长水国际机场XIY西安咸阳国际机场HGH杭州萧山国际机场
直接调用 API（无需脚本）#
text
GET https://apis.juhe.cn/flight/query?departure=BJS&arrival=SHA&departureDate=2025-06-18&key=YOUR_KEY
AI 使用指南#
当用户查询航班信息时，按以下步骤操作：
- 识别参数 — 从用户消息中提取出发地、目的地、出发日期
- 转换机场代码 — 如用户提供城市名，需转换为机场三字代码
- 调用接口 — 使用参数调用航班查询 API
- 展示结果 — 清晰展示航班信息
返回字段说明#
字段含义示例airline航空公司代码CAairlineName航空公司名称中国国际航空flightNo航班号CA0953departure出发机场代码PEKdepartureName出发机场名称北京首都国际机场departureTime起飞时间09:05arrival到达机场代码PVGarrivalName到达机场名称上海浦东国际机场arrivalTime到达时间17:05duration飞行时长08h00mtransferNum中转次数0/1/2ticketPrice机票价格1506.3segments航段详情[...]
错误处理#
情况处理方式error_code 10001/10002API Key 无效，引导用户至 聚合数据 重新申请error_code 10012当日免费次数已用尽，建议升级套餐参数错误提示用户检查出发地/目的地/日期是否正确，日期格式应为 yyyy-MM-dd ,例如：2026-01-01查询失败告知用户查询失败，请稍后重试
脚本位置#
scripts/flight_query.py — 封装了 API 调用、参数验证、结果格式化和错误处理。
关于聚合数据#
聚合数据（juhe.cn） 是国内专业的 API 数据服务平台，提供包括：
- 网络工具：IP 查询、DNS 解析、端口检测
- 生活服务：天气预报、万年历、节假日查询
- 交通出行： 航班查询、火车时刻表
- 物流快递：100+ 快递公司实时追踪
- 身份核验：手机号实名认证、身份证实名验证
注册即可免费使用，适合个人开发者和企业接入。
