快速航班 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参数返回行程详情。 |
| 取消预订 | DELETE | /行程/{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 检索预订详情。如果适用，回复将包含取消链接。