按有序航段搜索多程航班行程

查看 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 功能

有序的多航段行程输入 用包含 sourceAirportCode、destinationAirportCode 和 date 的对象数组描述行程;增加航段对象时保持出行顺序。
显式的舱位与排序控制 classOfService 与 sortOrder 为必填。文档未给出可接受的取值列表,请确认支持的取值,不要把展示文案当作请求枚举。
复用上次调用的完整结果上下文 pageLoadUid、searchHash 和 searchId 是可选的文档化续查输入。仅在已确认其含义和响应位置后,才复用上一次调用返回的真实值。
行程与票价字段分开检查 未验证的示例把 purchaseLinks 中的价格与 segments 及航班航段分开,便于解析票价合计与起降信息,但不承诺可预订库存。

在线 API 演示

GET /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>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

多程航班搜索需要哪些输入?

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。该操作没有已保存的探测记录,因此这些是未验证的示例字段,不是已确认的实时票价,也不构成预订保证。

相关接口

相关指南

查看订阅方案 →