太阳集团城8722(中国·Macau)有限公司-Official website

航班订票查询

支持MCP

通过出发地、目的地、出发日期等信息查询航班信息。

官 稳 保
  • 接口文档

  • MCP服务

    接口文档
  • 航班查询

  • 错误码
  • 错误码列表
  • 资源下载
  • 接口文档下载
航班查询
接口地址:https://apis.juhe.cn/flight/query
请求方式:http get/post
返回类型:json
接口描述:通过出发地、目的地、出发时候查询航班信息
接口调试: API测试工具

请求Header:

名称
  Content-Type application/x-www-form-urlencoded

请求参数说明:

名称 必填 类型 说明
  departure string 出发地城市码或机场码(IATA代码)
例如北京三字码:BJS, 上海三字码:SHA, 广州三字码:CAN
  arrival string 目的地城市码或机场码(IATA代码)
例如北京三字码:BJS, 上海三字码:SHA, 广州三字码:CAN
  departureDate string 行程出发日期,如:2025-12-21
  flightNo string 航班号,如:MU8218
填写航班号时,出发地和目的地填写机场码
  maxSegments string 行程的航段数量,默认:0
0 - 任意;1 - 仅限1个航段(直飞);2 - 最多2个航段(1次中转或更少);3 - 最多3个航段(2次中转或更少)
  key string 在个人中心->我的数据,接口名称上方查看

请求代码示例:

  • curl
  • PHP
  • Python
  • Go
  • C#
  • Node
  • Java
  • ObjectC
curl -k -i "https://apis.juhe.cn/flight/query?key=key&departure=xxx&arrival=xxx&departureDate=xxx&flightNo=&maxSegments="

返回参数说明:

名称 类型 说明
  error_code int 状态码
  reason string 请求描述
  result object 请求结果
  orderid string 太阳集团城8722单号
  flightInfo object 航班信息类表
  airline string 航司代码
  airlineName string 航司名称
  flightNo string 航班号
包括:多航段和共享航班的航班号, 如:多航段(CA0953/CA0916)
  isCodeShare bool 是否包含共享航班
  departure string 出发机场码
  departureName string 出发机场名称
  departureDate string 出发日期
  departureTime string 出发时间
  arrivalDate string 到达日期
  arrivalTime string 到达时间
  arrival string 目的地机场码
  arrivalName string 目的地机场名称
  duration string 航班时长
  transferNum int 航段数量
  ticketPrice float 参考票价
  segments object 多航段航班列表
仅当航段数大于1的时候返回

其他使用说明:

机场IATA三字码清单下载:IATA.xlsx
本服务已经接入太阳集团城8722MCP中心,您可以访问:https://juhe.cn/mcp 了解。

JSON返回示例:JSON在线格式化工具 >

      {
  "reason": "成功", 
  "result": { 
    "orderid": "JH818250617094826CZLKl", /*太阳集团城8722单号*/
    "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, /*航段数量,1代表直飞,大于1表示需转机*/
        "ticketPrice": 15063, /*参考票价*/
        "segments": [   /*多航段航班列表,仅当航段数大于1的时候返回*/           
          {
            "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 /*状态码*/
}

服务级错误码参照(error_code):

  错误码 说明
  281801 参数错误
  281802 网络错误
  281804 查询失败

系统级错误码参照:

  错误码 说明 旧版本(resultcode)
  10001 错误的请求KEY 101
  10002 该KEY无请求权限 102
  10003 KEY过期 103
  10004 错误的OPENID 104
  10005 应用未审核超时,请提交认证 105
  10007 未知的请求源 107
  10008 被禁止的IP 108
  10009 被禁止的KEY 109
  10011 当前IP请求超过限制 111
  10012 请求超过次数限制 112
  10013 测试KEY超过请求限制 113
  10014 系统内部异常(调用充值类业务时,请务必联系客服或通过订单查询接口检测订单,避免造成损失) 114
  10020 接口维护 120
  10021 接口停用 121

错误码格式说明(示例:200201):

  2 002 01
  服务级错误(1为系统级错误) 服务模块代码(即数据ID) 具体错误代码

接口文档下载

1 开通服务能力
2 选择连接服务
3 开始使用
通过 SSE URL 连接服务
通过 StreamableHTTP 连接服务
支持的工具
查看文档
航班订票查询
1369
申请次数
818
ID
1
收藏次数

推荐API

  • 短信API服务

    支持三大运营商,虚拟运营商短信发送,电信级运维保障,独享专用通道,3秒可达,99.99%到达率,支持大容量高并发——超低资费
  • 运营商基站信息

    支持全球200多个国家或地区,以及国内三网运营商基站位置信息数据查询。
  • ai联网搜索

    强大的数据积累,依托海量的数据,返回内容丰富度高,包含url、网页标题、正文摘要等,在需要时能够实时访问互联网信息,从而突破信息壁垒,实现更精准、更全面的输出。
  • 火车订票查询

    通过站到站查询火车班次时刻表等信息,同时已集成至太阳集团城8722MCP Server。火车票订票MCP不仅能赋予你的Agent火车时刻查询,还能支持在线订票能力。
  • 经济能力评级(个税)

    基于被查询人既往12个月个税缴纳数据,通过模型计算出被查询人的个税经济能力评级

API资讯

数 据 驱 动 未 来
Data Drives The Future
0512-88869195
数 据 驱 动 未 来
Data Drives The Future
XML 地图