## 航班信息查詢  > 航班實時、歷史起降時間查詢 ## 接口費用（ [點擊購買](https://market.topthink.com/product/326)） > 最低 0.15元/次 ## 接口調用（[調用須知](https://docs.topthink.com/think-api/1835086)） ## 接口1：實時起降信息查詢 當日航班，方式1:可通過出發城市和到達城市三字碼查詢起降信息；方式2:通過指定航班號查詢起降信息 ### 請求地址 ``` GET https://api.topthink.com/flight/query ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是| string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | orgCity | 是 | string | 始發城市的三字碼（方式1必傳） | | dstCity | 是 | string | 到達城市的三字碼（方式1必傳） | | flightNo | 是 | string | 航班號 （方式2必傳） | ### 返回`data`參數 | 名稱 | 類型 | 說明 | | --- | --- | --- | | FlightNo | 字符串 | 航班號 | | Rate | 字符串 | 準點率 | | DepCity | 字符串 | 出發城市名稱 | | DepCode | 字符串 | 出發港口三字碼 | | ArrCity | 字符串 | 到達城市名稱 | | ArrCode | 字符串 | 到達港口三字碼 | | DepTerminal | 字符串 | 出發港口航站樓 | | ArrTerminal | 字符串 | 到達港口航站樓 | | DepScheduled | 時間類型 | 計劃起飛時間 | | ArrScheduled | 時間類型 | 計劃到達時間 | | DepEstimated | 時間類型 | 預計起飛時間 | | ArrEstimated | 時間類型 | 預計到達時間 | | DepActual | 時間類型 | 實際起飛時間 | | ArrActual | 時間類型 | 實際到達時間 | | FlightState | 字符串 | 航班狀態，計劃／起飛／延誤／到達／備降／取消 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->flightQuery() ->withOrgCity('PEK') ->withDstCity('WUH') ->request(); dump($result); ``` 返回示例 ``` { "code": 0, "message": "成功", "data":[ { "FlightNo": "CZ9378", "Rate": "92.00", "DepCity": "北京首都", "DepCode": "PEK", "ArrCity": "武漢天河", "ArrCode": "WUH", "DepTerminal": "T2", "ArrTerminal": "T2", "DepScheduled": "2014-12-19T08:05:00", "ArrScheduled": "2014-12-19T10:15:00", "DepEstimated": "2014-12-19T08:23:00", "ArrEstimated": "2014-12-19T09:40:00", "DepActual": "2014-12-19T08:23:00", "ArrActual": "2014-12-19T10:09:00", "FlightState": "到達", "arrRate": "93" }, { "FlightNo": "MU2460", "Rate": "92.00", "DepCity": "北京首都", "DepCode": "PEK", "ArrCity": "武漢天河", "ArrCode": "WUH", "DepTerminal": "T2", "ArrTerminal": "T2", "DepScheduled": "2014-12-19T08:05:00", "ArrScheduled": "2014-12-19T10:15:00", "DepEstimated": "2014-12-19T08:05:00", "ArrEstimated": "2014-12-19T10:15:00", "DepActual": "2014-12-19T08:23:00", "ArrActual": "2014-12-19T10:09:00", "FlightState": "到達", "arrRate": "90.67" }, { "FlightNo": "MU3185", "Rate": "92.00", "DepCity": "北京首都", "DepCode": "PEK", "ArrCity": "武漢天河", "ArrCode": "WUH", "DepTerminal": "T2", "ArrTerminal": "T2", "DepScheduled": "2014-12-19T08:35:00", "ArrScheduled": "2014-12-19T10:45:00", "DepEstimated": "2014-12-19T08:51:00", "ArrEstimated": "2014-12-19T10:48:00", "DepActual": "2014-12-19T08:51:00", "ArrActual": "2014-12-19T10:38:00", "FlightState": "到達", "arrRate": "89.33" }, { "FlightNo": "MF4777", "Rate": "92.00", "DepCity": "北京首都", "DepCode": "PEK", "ArrCity": "武漢天河", "ArrCode": "WUH", "DepTerminal": "T2", "ArrTerminal": "T2", "DepScheduled": "2014-12-19T08:35:00", "ArrScheduled": "2014-12-19T10:45:00", "DepEstimated": "2014-12-19T08:51:00", "ArrEstimated": "2014-12-19T10:48:00", "DepActual": "2014-12-19T08:51:00", "ArrActual": "2014-12-19T10:38:00", "FlightState": "到達", "arrRate": "89.67" }, { "FlightNo": "CZ6605", "Rate": "95.00", "DepCity": "北京首都", "DepCode": "PEK", "ArrCity": "武漢天河", "ArrCode": "WUH", "DepTerminal": "T2", "ArrTerminal": "T2", "DepScheduled": "2014-12-19T08:35:00", "ArrScheduled": "2014-12-19T10:45:00", "DepEstimated": "2014-12-19T08:30:00", "ArrEstimated": "2014-12-19T10:38:00", "DepActual": "2014-12-19T08:51:00", "ArrActual": "2014-12-19T10:38:00", "FlightState": "到達", "arrRate": "90" } ] } ``` ## 接口2：歷史起降信息查詢 ### 請求地址 ``` GET https://api.topthink.com/flight/history ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是| string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | flightNo | 是 | string | 航班號 | | flightDate | 是 | Date | （年月日） | ### 返回`data`參數 | 名稱 | 類型 | 說明 | | --- | --- | --- | | FlightNo | 字符串 | 航班號 | | Rate | 字符串 | 準點率 | | DepCity | 字符串 | 出發城市名稱 | | DepCode | 字符串 | 出發港口三字碼 | | ArrCity | 字符串 | 到達城市名稱 | | ArrCode | 字符串 | 到達港口三字碼 | | DepTerminal | 字符串 | 出發港口航站樓 | | ArrTerminal | 字符串 | 到達港口航站樓 | | DepScheduled | 時間類型 | 計劃起飛時間 | | ArrScheduled | 時間類型 | 計劃到達時間 | | DepEstimated | 時間類型 | 預計起飛時間 | | ArrEstimated | 時間類型 | 預計到達時間 | | DepActual | 時間類型 | 實際起飛時間 | | ArrActual | 時間類型 | 實際到達時間 | | FlightState | 字符串 | 航班狀態 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->flightHistory() ->withFlightNo('MF4777') ->withFlightDate('2014-12-10') ->request(); dump($result); ``` 返回結果示例: ``` { "code": 0, "message": "成功", "data": { "FlightNo": "MF4777", "Rate": "0", "DepCity": "北京首都", "DepCode": "PEK", "ArrCity": "武漢天河", "ArrCode": "WUH", "DepPort": "北京首都", "ArrPort": "武漢天河", "DepTerminal": "T2", "ArrTerminal": "T2", "DepScheduled": "2014-12-10T08:35:00", "ArrScheduled": "2014-12-10T10:45:00", "DepEstimated": "2014-12-10T11:00:00", "ArrEstimated": "2014-12-10T13:08:00", "DepActual": "2014-12-10T11:21:00", "ArrActual": "2014-12-10T13:06:00", "FlightState": "到達", "Delay_Time": "0", "arrRate": "89" } } ``` ## 接口3：根據航班號日期查詢未來航班信息 ### 請求地址 ``` GET https://api.topthink.com/flight/future ``` ### 請求參數 | 名稱 | 必填 | 類型 | 說明 | | --- | --- | --- | --- | | appCode| 是| string|用戶授權碼，參考[API調用](https://docs.topthink.com/think-api/1835086) | | flightNo | 是 | string | 航班號 | | flightDate | 否 | string | 航班日期，默認明天 | ### 返回`data`參數 | 名稱 | 類型 | 說明 | | --- | --- | --- | | FlightNo | 字符串 | 航班號 | | DepCity | 字符串 | 出發城市名稱 | | DepCode | 字符串 | 出發港口三字碼 | | ArrCity | 字符串 | 到達城市名稱 | | ArrCode | 字符串 | 到達港口三字碼 | | DepTerminal | 字符串 | 出發港口航站樓 | | ArrTerminal | 字符串 | 到達港口航站樓 | | DepScheduled | 時間類型 | 計劃起飛時間 | | ArrScheduled | 時間類型 | 計劃到達時間 | | DepEstimated | 時間類型 | 預計起飛時間 | | ArrEstimated | 時間類型 | 預計到達時間 | | DepActual | 時間類型 | 實際起飛時間 | | ArrActual | 時間類型 | 實際到達時間 | | FlightState | 字符串 | 航班狀態，未來航班均為 計劃 | ## SDK調用 ``` $client = new Client("YourAppCode"); $result = $client->flightFuture() ->withFlightNo('MF4777') ->withFlightDate('2019-04-02') ->request(); dump($result); ``` 返回結果示例: ``` { "code": 0, "message": "成功", "data":{ "FlightNo": "MU4682", "DepCity": "北京", "DepCode": "PEK", "ArrCity": "上海", "ArrCode": "SHA", "DepTerminal": "T3", "ArrTerminal": "T2", "DepScheduled": "2019-04-02T06:50:00", "ArrScheduled": "2019-04-02T09:05:00", "DepEstimated": "2019-04-02T06:50:00", "ArrEstimated": "2019-04-02T09:05:00", "DepActual": "0001-01-01T00:00:00", "ArrActual": "0001-01-01T00:00:00", "PlaneStyle": "321", "FlightState": "計劃", "arrRate": [], "arrRate_attr": { "xsi:nil": "true" } } } ```