查询多城市、多航段机票
查看 Skyscanner 天巡机票与酒店查询 的全部接口 →把行程作为序列化的 JSON 数组字符串传入必填 legs 查询参数。每段按文档填写 originSkyId、destinationSkyId 和 YYYY-MM-DD 格式的 date;地点标识先通过机场搜索获取,各段日期应按出行顺序排列。这是 GET 查询参数,不是 JSON 请求体。可选 adults、cabinClass 与 currency 描述整次搜索。多城市响应尚未单独核实,不应直接套用单程搜索结构或假定存在会话轮询字段。即使返回组合报价,也不能据此认定包含联程保障、行李直挂或受保护的转机衔接,需检查实际方案后再比较。
API 功能
航段数组作为查询字符串传递 将 JSON 数组序列化并编码到 legs 查询值中,不移动到该 GET 接口不支持的请求体。
每段独立指定出发日 逐段设置 originSkyId、destinationSkyId 与未来日期,确保航段顺序和日期逻辑一致。
整次多程搜索共享乘客设置 adults、cabinClass 和 currency 在外层指定,不需要在每一段 JSON 中重复填写。
组合报价不等于联程保障 核实具体返回方案后再说明票务组合、行李转运和转机责任,不仅根据总价作出保证。
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
GET
/api/project/skyscanner/flights-search-flights-multi-stops API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/flights-search-flights-multi-stops?key=<API_KEY>&legs=<legs>¤cy=USD'
curl -X GET 'https://api.opendata-api.com/api/project/skyscanner/flights-search-flights-multi-stops?key=<API_KEY>&legs=<legs>¤cy=USD'
查询结果
需要帮助?
如遇接口异常,或需要其他接口需求,可联系我们
使用场景
- 多城市行程编辑器:将伦敦—巴黎—纽约等出行计划保存为按日期排序的航段,再序列化查询。
- 多程与分段买票比较:对比可用的组合报价和单独点对点搜索,不将便宜方案自动标为受保护联程。
- 出行顺序校验:提交前检查各段未来日期与时间先后,提示明显冲突的旅行计划。
- 行程条件复用:单独保存航段定义而非只存报价,方便以后按同一多城市计划重新查询。
常见问题
多城市机票的 legs JSON 参数应该怎么传?
先用机场搜索确认各地 skyId,再构建包含 originSkyId、destinationSkyId、date 的数组并序列化为字符串。Python 可用 json.dumps 生成值,再交给 requests 的 params 编码到 legs;不要作为 JSON 请求体发送。每段使用未来日期并按实际出行顺序排列。
多航段有一个总价,就意味着行李直挂和转机保障吗?
不是。多城市响应结构尚未单独核实,组合报价本身不能说明是否同一票、是否行李直挂或是否提供衔接保障。应检查实际返回的报价与条件,不假定它与单程响应相同,也不假定支持相同的会话续查方式。