获取指定航线与出行日期的航班筛选项元数据
查看 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 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/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>'
查询结果
使用场景
- 根据返回的分组标题与 label/value 选项原型一个航班搜索侧边栏,并分别处理分类筛选项和时间范围筛选项两种条目结构。
- 在修改航线或舱位后,对比已保存的筛选项元数据,判断此前选中的界面选项是否需要重新检查。
- 测试一个收集出发日期、机场代码、舱位等级和行程类型的航班表单,并在往返行程时显示返程日期控件。
- 审查航班筛选项快照中是否存在空分组、重复的 param 条目或发生变化的选项值,然后再更新客户端的筛选处理逻辑。
- 为返回的筛选 param 名称与另一份航班搜索接口契约准备文档化的映射审查,同时不要假设搜索接口接受每一个元数据键。
常见问题
获取航班筛选项需要哪些查询参数?
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),并在转发筛选名称或取值之前,先核实另一个搜索接口的契约。名称相同并不能证明二者兼容。
筛选响应能证明当前有航班可订或票价吗?
不能。它描述的是筛选项元数据,而不是可预订的行程或已确认的价格。该操作没有已保存的探测调用,所提供的源示例也被截断,因此不应据此推断当前选项、完整的外层字段或库存情况。