GET已開放flight-query

飛機航班資訊查詢

透過出發地、目的地、出發日期等資訊查詢航班資訊。

呼叫價格

12 匠幣/次

線上除錯

無需寫程式，瀏覽器中直接發起真實請求

接入文件

介面簡介

本介面支援透過出發地、目的地和出發日期，查詢國內及國際航班的詳細行程資訊。返回資料包含航空公司程式碼、航班號、起降機場三字碼、具體起降時間、飛行時長、中轉次數以及參考票價。

適用場景

差旅管理系統：為企業員工提供實時的航班時刻檢索與比價功能。
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	{...}

響應欄位