覆盖国内外 4,200+ 条航线的实时航班动态查询，支持按航班号、出发城市、到达城市检索航班起降状态、延误信息与登机口，适用于出行规划、机场接送、物流调度等业务场景。
航班动态 API 通过标准 HTTP GET 请求返回结构化 JSON 数据，支持按航班号精确查询或按出发/到达城市模糊查询。返回字段涵盖航司、机场、计划/实际起降时间、航班状态（计划、延误、取消、到达等）、登机口及行李转盘等信息。数据每 15 分钟刷新一次，全程 HTTPS 加密传输，适用于 App、小程序及后台系统集成。
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| apikey | string | 是 | 用户身份密钥，在控制台「应用管理」中创建应用后获取。 |
| flight_no | string | 否 | 航班号，如「CA1234」「MU5101」，与出发/到达城市二选一。 |
| dep_city | string | 否 | 出发城市名称，如「北京」「上海」，可与 arr_city 组合查询。 |
| arr_city | string | 否 | 到达城市名称，如「广州」「深圳」，可与 dep_city 组合查询。 |
| date | string | 否 | 查询日期，格式 yyyy-MM-dd，默认当天；支持查询前后 3 天。 |
| 字段名 | 类型 | 说明 |
|---|---|---|
| code | int | 状态码，200 表示请求成功，其余见错误码对照表。 |
| msg | string | 状态描述信息。 |
| data.flight_no | string | 航班号，如 CA1831。 |
| data.airline | string | 航空公司名称，如中国国际航空。 |
| data.dep_airport | string | 出发机场全称，如北京首都国际机场。 |
| data.arr_airport | string | 到达机场全称，如上海虹桥国际机场。 |
| data.dep_time | string | 计划起飞时间，格式 yyyy-MM-dd HH:mm。 |
| data.arr_time | string | 计划到达时间，格式 yyyy-MM-dd HH:mm。 |
| data.status | string | 航班状态：计划、起飞、到达、延误、取消。 |
| data.gate | string | 登机口编号，如 A12。 |
| data.update_time | string | 数据更新时间，格式 yyyy-MM-dd HH:mm:ss。 |
{
"code": 200,
"msg": "success",
"data": {
"flight_no": "CA1831",
"airline": "中国国际航空",
"dep_airport": "北京首都国际机场 T3",
"arr_airport": "上海虹桥国际机场 T2",
"dep_time": "2026-07-25 08:30",
"arr_time": "2026-07-25 10:50",
"status": "到达",
"gate": "A12",
"update_time": "2026-07-25 11:05:00"
}
}