继续查询尚未完成的航班搜索
查看 Skyscanner 天巡机票与酒店查询 的全部接口 →将你自己的初次航班搜索返回的 sessionToken 原样作为必填 sessionId,继续获取同一搜索的结果,并保持 currency 与 countryCode 和初次请求一致。已测试的初次搜索在 RESULT_STATUS_INCOMPLETE 下返回了可用行程和非空会话值,但本继续查询接口尚未单独核实,不能承诺最终响应结构、完成数量或会话有效期。接入时检查每次实际返回的内容,仅合并可用行程;若有行程标识则据此去重,明确完成或达到应用设置的超时后停止。搜索会话是临时请求上下文,应来自你有权使用的搜索并保持私密,不要把捕获的值写入公开示例,也不要用账号或浏览器会话替代。
API 功能
用本次搜索返回值继续查询 sessionId 接收初次航班响应的 sessionToken,不接受随意填写的账号登录会话或无关浏览器会话。
保持续查的币种与国家上下文 沿用原始 currency 与 countryCode,避免把不同查询条件下的结果混在同一次价格比较中。
由应用限制轮询次数与时长 自行设定退避间隔、请求上限和超时,不依赖未公开确认的完成时间或会话寿命。
核实增量结果后再合并 逐次检查后续响应,仅接纳可用行程;没有明确完成依据时继续标记为部分结果。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/skyscanner/flights-search-incomplete API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/flights-search-incomplete?key=<API_KEY>&sessionId=<sessionId>¤cy=USD&countryCode=US'
curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/flights-search-incomplete?key=<API_KEY>&sessionId=<sessionId>¤cy=USD&countryCode=US'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 渐进式机票结果页:先展示已有报价,在应用主动续查同一搜索时保留加载与未完成提示。
- 增量行程去重:检查后续返回的行程标识,避免向旅行比价候选清单反复追加同一方案。
- 有界搜索等待:达到应用设置的截止时间便停止轮询,保留部分结果而非无限发起请求。
- 明确的续查或重搜操作:会话可用时由用户主动继续查询,失效或缺失时重新提交航线搜索。
常见问题
初次响应里的 sessionToken 应该传给哪个参数?
把你自己的航班搜索返回的 sessionToken 原样传给本接口的 sessionId,并保持 currency 与 countryCode 一致。这是该次搜索的临时上下文,不是平台 API 密钥,也不是账号登录令牌;请勿公开共享或写入日志。
应该轮询多久,能保证得到完整结果吗?
本接口的最终响应字段、完成时间和会话有效期尚未单独核实,不能保证固定次数后完成。应用应根据实际状态设置退避、最大次数与超时,按可用标识去重;只有明确完成时才标记完成,超时则说明结果仍是部分结果,必要时重新搜索。