获取指定航线与出行日期的航班筛选项元数据

查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →

使用必填的字符串查询参数 classOfService、date、destinationAirportCode、itineraryType 和 sourceAirportCode 获取航班搜索的筛选项元数据。出发日期格式为 YYYY-MM-DD。文档记载的 itineraryType 取值为 ONE_WAY 和 ROUND_TRIP。returnDate 是可选的字符串,格式同为 YYYY-MM-DD;现有证据没有确立往返行程下的条件校验规则。机场代码可通过机场搜索操作获得,文档中的输入示例为 BOM 和 DEL。classOfService 没有提供可接受的取值清单。被截断的 HTTP 200 源示例显示 data.filters 是一组筛选分组的数组,每组包含 param、title 和嵌套的 filters 字段。分类类条目含有字符串 label 与 value;时间范围类条目含有数值型 index、rangeMin、rangeMax,以及字符串 title 和 subTitle。可见的分组涉及经停次数、改签/取消政策、航班时间、航空公司、航空联盟、飞行时长、中转机场和价格,部分嵌套的 filters 数组为空。这些字段来自一个不完整的源示例,而非已保存的探测调用,完整的外层结构、范围单位、响应必填字段以及当前筛选项的可用性均未验证。返回的 param 名称和取值只是元数据,不是本操作额外声明的输入,也不能证明与其他接口兼容。该响应不是航班行程列表、票价报价或预订结果。

API 功能

按航线区分的筛选请求输入 通过 sourceAirportCode、destinationAirportCode、date、itineraryType 和 classOfService 来描述所需行程,而不是请求一份通用的静态筛选清单。
单程与往返行程选择 文档记载的 itineraryType 取值为 ONE_WAY 和 ROUND_TRIP。returnDate 在声明的结构中仍是可选的,日期格式同样是 YYYY-MM-DD。
分类筛选项的展示元数据 示例片段提供了分组的 param 与 title 字段,以及嵌套的 label/value 条目,覆盖经停次数、航空公司、中转机场等分类。
时间范围筛选项的条目结构 可见的 flightTimes 条目使用 index、rangeMin、rangeMax、title 和 subTitle,而不是分类筛选项的 label/value 结构;数值范围的单位没有文档说明。
留意空的筛选分组 部分文档化的分组包含空的 filters 数组。客户端可以保留分组元数据,同时避免虚构可供选择的选项。

在线 API 演示

GET /api/project/tripadvisor-data/get-filters

调用成本暂不可用,未假定任何价格。

查看价格

API 响应 (JSON)

{}
curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-filters?key=<API_KEY>&classOfService=<classOfService>&date=<date>&destinationAirportCode=<destinationAirportCode>&itineraryType=ONE_WAY&sourceAirportCode=<sourceAirportCode>'
📢
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
联系我们

使用场景

常见问题

获取航班筛选项需要哪些查询参数?

classOfService、date、destinationAirportCode、itineraryType 和 sourceAirportCode 是必填字符串,returnDate 是可选字符串。该请求没有声明路径或请求体输入。

itineraryType 和日期字段应该使用什么格式?

单程使用 ONE_WAY,往返使用 ROUND_TRIP。date 是出发或出行日期,格式为 YYYY-MM-DD;提供 returnDate 时同样使用 YYYY-MM-DD。结构中 returnDate 为可选,所提供的证据没有确立其他条件规则。

机场代码和舱位等级的取值从哪里获得?

参数文档指示从机场搜索操作中获取 airportCode 的值,BOM 和 DEL 分别是出发地与目的地的示例。classOfService 指旅客的舱位等级,但没有提供可接受的取值清单或默认值,因此这里不断言某个具体的舱位取值。

可以用哪些响应字段来渲染筛选控件?

源示例片段显示 data.filters 是分组数组,包含 param、title 和嵌套的 filters。分类条目带有字符串 label 和 value;航班时间条目则带有数值型 index、rangeMin、rangeMax 以及字符串 title 和 subTitle。片段中含有空的嵌套数组,并且没有记录范围单位或完整的响应结构。

能把返回的筛选 param 名称再传回这个接口吗?

它们是响应元数据,不是本操作额外声明的输入。请保留返回时的准确拼写(包括示例中的键 covidPolices),并在转发筛选名称或取值之前,先核实另一个搜索接口的契约。名称相同并不能证明二者兼容。

筛选响应能证明当前有航班可订或票价吗?

不能。它描述的是筛选项元数据,而不是可预订的行程或已确认的价格。该操作没有已保存的探测调用,所提供的源示例也被截断,因此不应据此推断当前选项、完整的外层字段或库存情况。

相关接口

相关指南

查看订阅方案 →