Skyscanner 天巡机票与酒店查询 APIs

先从机场搜索中选定出发地和目的地，分别传入同一条地点建议的 skyId 与 entityId，再提供未来的出发日期 date，格式为 YYYY-MM-DD。单程查询不传 returnDate；往返查询需提供晚于出发日的返程日期。可选参数包含成人、儿童、婴儿人数、舱位、币种、market 与 countryCode。已测试的单程响应包含 sessionToken、status、total 和 itineraries；行程带有 id、price.amount/currency/formatted、legs、score、tags 与 bookingUrl，航段带有实际机场、起降时间、durationMinutes、stopCount 和航空公司名称及 logoUrl。伦敦城市搜索曾返回希思罗至肯尼迪机场的方案，因此城市标识不等于只选择一个机场。RESULT_STATUS_INCOMPLETE 时也可能已有可用报价，可将 sessionToken 作为 sessionId 继续查询，不应把首批 total 当作最终数量。报价与链接只代表当次观察，本接口不出票；往返响应尚未单独核实。

传入机场或城市名称 query，可选 market 与 locale 控制查询地区和语言区域。已测试响应的 places 包含 skyId、entityId、iataCode、name、cityName、countryName、placeType 和 coordinates.lat/lng。London 曾返回 CITY 类型的伦敦城市建议（LOND、27544008），以及希思罗等 AIRPORT 建议；希思罗对应 LHR、95565050。选定后将该条建议的配套标识用于航班搜索，注意城市范围与单一机场的区别。有效机场的 iataCode 也可能是空字符串，不应因此丢弃已返回 skyId/entityId 的建议。不存在的名称在测试中返回 HTTP 200 与 places:[]，属于正常未命中，不是服务中断；建议的顺序与数量可能变化。

将你自己的初次航班搜索返回的 sessionToken 原样作为必填 sessionId，继续获取同一搜索的结果，并保持 currency 与 countryCode 和初次请求一致。已测试的初次搜索在 RESULT_STATUS_INCOMPLETE 下返回了可用行程和非空会话值，但本继续查询接口尚未单独核实，不能承诺最终响应结构、完成数量或会话有效期。接入时检查每次实际返回的内容，仅合并可用行程；若有行程标识则据此去重，明确完成或达到应用设置的超时后停止。搜索会话是临时请求上下文，应来自你有权使用的搜索并保持私密，不要把捕获的值写入公开示例，也不要用账号或浏览器会话替代。

用你自己的航班搜索结果中的 itineraryId，以及同一次搜索的 sessionToken（作为 sessionId）查询选中行程，币种和 countryCode 也应沿用原搜索设置。该接口用于查看行程详情与预订选项，但返回结构尚未单独核实，不能假定一定包含行李额度、票价规则、全部销售渠道或某个固定详情字段。展示前检查实际内容；行程不可用或会话失效时重新搜索，不要构造 ID 或承诺报价永久有效。这是只读报价查询，不付款、不出票，也不创建预订。

把行程作为序列化的 JSON 数组字符串传入必填 legs 查询参数。每段按文档填写 originSkyId、destinationSkyId 和 YYYY-MM-DD 格式的 date；地点标识先通过机场搜索获取，各段日期应按出行顺序排列。这是 GET 查询参数，不是 JSON 请求体。可选 adults、cabinClass 与 currency 描述整次搜索。多城市响应尚未单独核实，不应直接套用单程搜索结构或假定存在会话轮询字段。即使返回组合报价，也不能据此认定包含联程保障、行李直挂或受保护的转机衔接，需检查实际方案后再比较。

传入 originSkyId、destinationSkyId 和必填 fromDate，可用 toDate 明确未来的 YYYY-MM-DD 日期范围；currency、market 与 cabinClass 为可选比较条件。已测试响应包含 currency 和 outboundDates，每条日期记录带 date、数值 price、group 与 hasQuote。伦敦—纽约的八天查询曾返回范围内每天的记录，以及 low、medium 等分组，但其他航线的覆盖可能不同。筛选最低报价时排除无记录或 hasQuote 为假的日期，不把缺失值视作零元机票。已测试结果没有 directPrice 或 isDirect，不能据此认定存在直飞。选中日期后仍需通过具体航线搜索核实可用行程，日历报价并非保证可订的最终价格。

使用 originSkyId、destinationSkyId 与 YYYY-MM 格式的 month 查询指定月份的单程报价，可选 currency 和 market。先从机场搜索取得航线标识，并选择未来的旅行月份。该接口用于按出发日比较单程低价报价，但实际响应字段与每日覆盖尚未单独核实，应先检查返回结构再提取日期和价格。无报价的日期是未知，不是零元；筛选出的候选日期需交给主航班搜索复查。整月报价不等于历史票价档案，也不保证覆盖所有销售渠道或提供全网最低价。

用 originSkyId、destinationSkyId 和未来出发起始日 fromDate 查询往返日期组合，日期格式为 YYYY-MM-DD。可选 returnFromDate 指定返程比较的起始日，currency 与 market 设置报价上下文。接口用于探索出发日与返程日组合，但实际价格矩阵结构、返回日期跨度和报价完整度尚未单独核实。当前输入没有任意出发结束日或返程结束日，不应添加未支持的范围控制。应用需检查实际日期对，排除返程早于出发的组合，在本地按旅行天数筛选，然后把选中的日期对交给往返航班搜索复查。

用机场搜索选出的 originSkyId/originEntityId 标识对发起不固定目的地的探索，可选 adults、cabinClass、currency 与 market。该接口没有目的地或出行日期参数，适合旅行灵感推荐，不应把建议描述为某个指定出发日的报价。实际响应与价格覆盖尚未单独核实，筛选或排序前需检查返回的目的地标识、地名和价格上下文。选定目的地后再进行具体航线与日期的机票查询；探索建议不保证涵盖全部目的地、所有直飞航线或全网最低价。

先用酒店目的地搜索获取 entityId，再传入未来的 checkIn/checkOut，格式为 YYYY-MM-DD，且退房必须晚于入住。可选 adults、rooms、currency 与 market 描述入住条件。已测试的巴黎响应包含 destinationName、total 和 hotels；酒店记录有 hotelId、name、stars、数值 rating、reviewCount、price.amount/currency、图片 URL 字符串数组 images、amenities、url、coordinates.lat/lng，以及表示街区的文本 distance。不要把 rating 当嵌套评分对象、images 当带说明的对象数组，也不要将 distance 换算为米。返回列表可能只是 total 的一部分，本接口未提供分页参数。单凭这些字段无法确定价格按晚还是按整段入住计费，也无法确认税费和房型条款；比较最终费用或引导预订前应另行核实。

以必填 query 搜索酒店目的地，可选 market 与 locale。已测试的 places 建议包含 entityId、name、type、hierarchy 和 coordinates.lat/lng。Paris 曾返回法国巴黎城市（entityId 27539733），也包含机场、街区与酒店建议，其中有拉斯维加斯的同名酒店。先结合 hierarchy 与 type 确认地理范围，再把所选 entityId 用于酒店搜索。hierarchy 是以竖线分隔的描述文本，type 的大小写可能不同，不要强行按未经确认的完整枚举过滤。该接口只返回目的地建议，不提供指定日期的房间或价格。

使用酒店搜索返回的 hotelId 和未来的 checkIn/checkOut 查询详情，可选 adults 与 currency 保持入住上下文。该接口用于提供设施、图片、政策等酒店内容，但实际字段名称和覆盖尚未单独核实。只展示返回中确实存在的信息，并区分酒店描述与指定日期的客房可用性；不能由描述推断可退款、入住人数规则或已确认库存。需要房型报价时应另外查询价格，本接口不预留房间、不创建住宿订单。

传入酒店搜索返回的 hotelId、对应目的地 entityId，以及未来且先后正确的 checkIn/checkOut，可选 adults 与 currency。接口用于查询房型和价格，但实际报价结构、按晚或整段入住的计价口径、税费与条款尚未单独核实。比较前检查返回金额与入住条件，不假定覆盖全部房型或全部销售渠道；保留原始币种和实际说明，不将未注明的金额标成每晚价、总价或含税价。该只读查询不预留库存、不锁定报价，也不创建订单。

使用酒店搜索选定的 hotelId 查询住客评价，可选数值 page 和 limit。评价字段、页码起点、可接受的条数上限和完整覆盖尚未单独核实，不应默认从某个页码开始、固定最大页大小或可导出全部评价。先检查本页实际评价与分页信息，再决定是否发起下一页请求。将评价始终关联到对应酒店，明确已获取样本不等于全部住客反馈；只有确实返回评价文本时才进行文本分析。

以真实酒店搜索结果中的 hotelId 为起点，提供未来 checkIn/checkOut，可选 adults 与 currency，寻找同区域或同类别的住宿替代建议。实际字段、相似标准与排序尚未单独核实，应仅比较返回中确实存在的属性，确认候选酒店 ID 后再进行后续查询。每个备选的入住期价格需要单独核实；推荐本身不保证设施等同、价格更低、有房可订或与原酒店之间存在某个确定距离。

以酒店目的地 entityId 和未来、有先后顺序的 checkIn/checkOut 发起面向位置展示的酒店查询，可选 adults 与 currency。虽然接口名称带有地图含义，但输入没有任意经纬度、半径或边界框。酒店搜索已观察到 coordinates.lat/lng，但这个独立接口的实际字段与覆盖尚未单独核实，使用前应确认返回是否有坐标。与景点或交通站点的距离由应用自行计算，不把文本街区 distance 当作米数；返回候选也不保证包含周边全部住宿库存。

用必填 query 搜索取还车地点，可选 market 与 locale。已测试的 Heathrow 响应包含 locations，每项带 locationId、name、type、coordinates.lat/lng、countryName 和 iataCode。希思罗机场 LHR 曾返回 locationId 95565050、type Airport；另一条希思罗 5 号航站楼车站建议为 TrainStation，iataCode 为空。保存前区分机场和车站，若接入其他租车服务，应先确认它接受本结果的标识格式。此接口只解析地点，不返回车辆类别、可租库存、销售渠道报价、租车价格或预订。

不需要查询参数，用于获取搜索设置的代码配置。文档按 markets、currencies 和 locales 分组，供航班、酒店与地点接口使用，但实际条目和允许的组合尚未单独核实。构建选项或校验已保存旅行偏好前，应读取实际返回，不假定任意币种、语言和市场地区都能自由组合。market 表示搜索市场上下文，locale 在支持处控制语言与区域格式，currency 表示报价币种；此接口本身不返回机票或酒店价格。

可选 baseCurrency 默认 USD。已测试的美元基准响应包含 base、date 和 rates，其中 rates 是币种代码到数值汇率的对象，含 EUR、GBP、JPY、CAD 等主要币种。测试时返回日期为前一天，应显示该日期而非宣称即时汇率。应用换算机票或酒店报价时保留原金额、原币种和汇率依据，确认价格来源币种与换算基准匹配。汇率用于比较估算，不是银行结算价或保证的预订付款汇率。只有美元基准经过独立测试，其他基准需核实返回 base 和所需汇率是否存在。