GETflight-query
フライト情報検索
出発地、目的地、出発日などの情報から、フライト・航空便情報を簡単に検索できます。
導入ドキュメント
インターフェースの紹介
このインターフェイスは、出発地、目的地、出発日を通じて国内線および国際線の詳細な旅程情報のクエリをサポートします。返されるデータには、航空会社コード、便名、出発地と到着地の空港の 3 桁コード、特定の離陸時間と着陸時間、飛行時間、乗り継ぎ回数、参考運賃が含まれます。
該当するシナリオ
- 旅行管理システム: 企業従業員向けに、リアルタイムのフライト スケジュール検索と価格比較機能を提供します。
- OTA プラットフォーム統合: 基本的なフライト データを補足し、直行便または乗り継ぎのオプションと推定時間を表示します。
- 旅行計画アプリケーション: 離陸時間と着陸時間、空港情報に基づいてユーザーが旅行計画を立てるのに役立ちます。
リクエストと返品の手順
- リクエストメソッド: GET
- 主要パラメータ: 出発地、目的地、出発日を入力する必要があります。
- 戻り構造:
flightInfo: フライトリストの配列。airline/airlineName: 航空会社の 2 文字のコードと中国語名。- 「出発/到着」: 出発空港と到着空港の 3 文字のコード (PEK、PVG など)。
出発時間/到着時間: 計画された離陸時間と着陸時間。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 | {...} |
レスポンス項目
以下の項目はサンプル JSON から自動抽出した参考情報です。
| パス | 型 | サンプル値 |
|---|---|---|
| type | string | object |
| properties | object | {...} |
| properties.reason | object | {...} |
| properties.reason.type | string | string |
| properties.reason.example | string | 成功 |
| properties.result | object | {...} |
| properties.result.type | string | object |
