按有序航段搜索多程航班行程
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →用必填的 classOfService、sortOrder 和 legs 查询参数搜索多个航段。每个航段使用 sourceAirportCode、destinationAirportCode 和 date;文档将其表示为航段对象的 JSON 数组,但 legs 参数声明的类型仍是 object。已保存的示例使用 2025 年 10 月的历史日期,查询当前行程时必须替换。currencyCode 为可选,文档说明可从货币列表接口获取。可选的 pageLoadUid、searchHash 和 searchId 被文档化为复用上一次调用的值以获取完整响应;它们在响应中的位置以及续查时机均未验证。被截断且未经验证的源示例显示 data.complete 和 data.flights。示例航班记录包含 itineraryTag,purchaseLinks 中带有 currency、totalPrice、totalPricePerPassenger 和税费字段,segments 的航段则包含 departureDateTime、arrivalDateTime、originStationCode、destinationStationCode 以及承运信息。没有已保存的专属探测记录能确认这些字段、可接受的舱位或排序取值、实时票价或可订状态。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/search-flights-multi-city API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/search-flights-multi-city?key=<API_KEY>&classOfService=<classOfService>&legs=%5B%7B%22sourceAirportCode%22%3A%22BOS%22%2C%22destinationAirportCode%22%3A%22LON%22%2C%22date%22%3A%222025-10-18%22%7D%2C%7B%22sourceAirportCode%22%3A%22LON%22%2C%22destinationAirportCode%22%3A%22BOS%22%2C%22date%22%3A%222025-10-26%22%7D%5D&sortOrder=<sortOrder>'
查询结果
使用场景
- 原型一个三站行程规划器,为每一对连续机场序列化一个带日期的航段对象。
- 用不同的抵达机场与续程出发机场建模开口行程,再对照返回的航段明细核对是否符合预期路线。
- 做一个结果获取实验:当上一次响应提供了真实的 searchId、searchHash 和 pageLoadUid 时保留这些值。
- 开发防御性的行程对比视图,把示例中的购买链接合计与航段时间、承运信息分开,不触发任何自动预订。
常见问题
多程航班搜索需要哪些输入?
classOfService、legs 和 sortOrder 是必填查询参数。currencyCode、pageLoadUid、searchHash 和 searchId 为可选。现有文档没有提供受支持的舱位或排序枚举。
legs 参数应该如何表示?
文档展示的是 JSON 对象数组,每个对象包含 sourceAirportCode、destinationAirportCode 和 YYYY-MM-DD 格式的 date。该参数声明类型为 object,通过查询参数发送,而不是请求体。在依赖它之前,请先核实实际的查询编码方式。
查询当前行程时能原样提交已保存的日期吗?
已保存的示例对 BOS 往返 LON 的行程使用 2025-10-18 和 2025-10-26。这些是历史示例日期,并不保证有可搜索的库存。请替换为实际行程的日期。
currencyCode 从哪里获取?
参数文档指向货币列表接口,给出的示例是 USD。请单独查阅该操作,并使用它实际返回的代码;航班搜索本身不是货币换算接口。
pageLoadUid、searchHash 和 searchId 有什么用途?
它们是可选输入,文档说明用于复用上一次调用的值以获取完整响应。没有已保存的探测记录能确认它们在响应中的位置、轮询间隔或完成协议。请不要编造取值,也不要假设每次响应都会返回全部三个。
文档列出了哪些行程字段,票价经过验证了吗?
被截断的源示例显示 data.complete、data.flights、purchaseLinks 价格字段,以及包含航段时间、机场代码和承运方的 segments。该操作没有已保存的探测记录,因此这些是未验证的示例字段,不是已确认的实时票价,也不构成预订保证。