快速航班 API 飛行員文檔
早期訪問預覽
本文檔是僅針對選定合作夥伴的早期存取預覽計畫的一部分。試點計畫將於 2025 年第四季啟動，並於 2026 年全面推出。
如果您有興趣成為試點或測試合作夥伴，請聯絡您的客戶經理。
Rapid /flights API 套件
Rapid Flights API 由一系列端點組成，這些端點共同實作 search-to-book 流。
了解快速航班端點
由於該產品仍處於早期訪問階段，請記住架構細節和功能仍處於積極開發中，在向合作夥伴全面發布該產品之前可能會發生變化。
| 操作 | 方法 | 剩餘 URI | 結果 |
|---|---|---|---|
| 搜尋可用航班 | POST | /flight-offers | 返回可用的優惠。 |
| 索取更多航班優惠詳情 | GET | /flight-offers/{offer_id} | 返回航班的詳細信息，包括價格明細和政策。 |
| 索取所選航班的座位圖 | GET | /flight-offers/{offer_id}/座位 | 如果有的話，返回航班座位圖。 |
| 提供所選預訂付款方式的詳細信息 | POST | /付款 | 傳回 payment_token，它位於建立預訂請求的正文中。 |
| 完成預訂 | POST | /行程/航班 | 返回行程 ID 和連結以檢索預訂詳情或完成付款會話。 |
| 透過行程 ID 請求現有預訂的詳細信息 | GET | /行程/{itinerary_id}/航班 | 透過itinerary_id參數返回行程詳情。 |
| 取消預訂 | 刪除 | /行程/{itinerary_id}/航班 | 取消現有預訂。 |
用例
您可以使用以下方法使用 Rapid Flights API 為您的客戶建立 end-to-end 預訂體驗。
步驟 1 - 搜尋可用的航班優惠
首先，使用 /flight-offers 端點讓旅客查看有哪些航班可用。
請查看以下關鍵參數：
| 關鍵參數 | 說明 | 範例 |
|---|---|---|
departure_airport | 航班出發的機場。 | LAS |
arrival_airport | 航班抵達的機場。 | LAX |
departure_date_time | 航班起飛的時間和日期。 | 2025-01-09T17:45:00-08:00 |
步驟 2 - 提供更多可用航班選項的詳細信息
在向您的客戶提供航班選項之前，請使用 /flight-offers/{offer_id> 端點以取得更多詳細資訊。
以下是旅客在預訂前需要了解的詳細資訊：
| 物件 | 用它來... |
|---|---|
amenities | 顯示可用的 in-flight 娛樂選項，例如 WiFi 或電影。 |
baggage_allowance | 請提供航班包含多少行李的詳細資料。 |
change_policy | 指出是否允許 post-booking 更改，如果允許，是否會產生額外費用。 |
meal_options | 飛行期間提供什麼食物，是否包含在內或需要額外收費。 |
步驟 3 - 幫助您的顧客選擇他們喜歡的座位
使用 /flight-offers/{offer_id}/seats 端點顯示座位圖 (如果有)，以便旅客可以選擇自己喜歡的飛機座位部分。
範例：
cabin_class: economy
exit_row_list:
- '17'
- '18'
rows:
- row_number: 16
seats:
- aisle: false
column: A
seat_number: 16A
availability: not_available
preferred: false
seat_codes:
- window
seat_token: Q11REWlbQV5VARNfBQBxQ14JXAVYTT1XEwtbXEcJUQpTAkBSR0sNFVUIZgVdFENZSxFqBwtRBlx9eDoSVgNGU0ZCQkFTbFFcRRJbF0BrAllcVAh5dTdDVlwVUURBTRRdbwBXR1JcAVMKAUlRBRUCWG1WDEACdg1XFlByBgRLA1wcBXEDABNwDFJbDRFBDA0BDFkOB1oNVA5Q步驟 4 - 付款
現在您可以使用 /payments 端點允許客戶註冊預訂的付款方式。
回應將包含 payment_token，它位於建立預訂請求的正文中。
步驟 5 - 建立預訂
使用 /itineraries/flight 端點完成預訂。
第 6 步 - 檢索預訂詳情
您可以使用 /itineraries/{itinerary_id}/flight 端點透過行程 ID 擷取預訂詳情。如果適用，回覆將包含取消連結。