Booking 酒店与旅行数据 APIs

使用已知目的地查询值（如纽约 city:20088325），并明确入住离店日期、成人数、房间数与币种。实测成功响应含 status=true、message=Success、currentPage、resultsPerPage、totalResultCount 和 data 数组；酒店行含 id、name、ufi、countryCode、住宿日期、评分、坐标、blockIds 及 priceBreakdown.grossPrice 的币种与金额。page_size=10 曾返回 20 条，应以实际分页元数据为准。目的地自动补全不可用；价格和匹配数会变化。

使用用户确认的位置文字，并明确入住离店日期、人数、房间数和币种。文档支持价格上下限、类别标识、床位数、页码及排序。该文字搜索接口尚未实测，不是已证实可替代失效住宿自动补全的方案。地点名称可能有歧义，展示结果前需核对酒店地理位置与实际响应字段。

使用已知 dest_id 及匹配的 dest_type，并提供住宿日期、人数、房间数与币种。纽约文档示例为 dest_id=20088325、dest_type=city，不是 stays-search 使用的带前缀 query。住宿自动补全不可用，须另行准备已知标识对。此接口尚未实测，将选中酒店交给详情接口前，需检查实际响应和酒店 ID。

以 latitude、longitude 为中心，使用公里半径搜索酒店。文档中 radius 默认 10，范围为 10 至 500。请明确日期、成人数、儿童年龄、房间数与币种，也可添加预算或类别筛选。该半径搜索尚未实测，需核对返回位置和距离行为，不能预先承诺所有结果严格落在圆内。

使用东北角 ne_lat、ne_lon 和西南角 sw_lat、sw_lon，并保持住宿日期与人数一致。此接口省略日期时的文档默认值存在矛盾，应明确填写 checkin_date 与 checkout_date。可用价格上下限、categories_filter、页码与排序细化搜索。实际响应及地图边缘的包含行为尚未实测。

使用已知 dest_id/dest_type，并与酒店搜索保持相同日期、人数、房间数和币种。文档指向 data.filters.options.genericId 作为类别标识，价格 sliderOptions.min/max 作为预算范围；这些字段仅有文档依据、尚未实测。首次先留空 categories_filter，检查实际选项，再复用适用于当前目的地和住宿条件的值。

为已知 dest_id/dest_type 和住宿查询条件读取文档支持的排序方式。文档要求使用响应中的选项名称作为酒店 sort 值，列举了 price、bayesian_review_score、distance、星级排序等。该接口尚未实测；界面仅应展示当前目的地流程返回的选项，不要套用航班或独立房源的排序值。

使用数字 hotel_id，可附住宿日期、成人数、儿童年龄、房间数、币种与语言。酒店 180769 曾返回 Hyatt Grand Central New York，status=true、message=Success；数据含酒店身份、城市国家、链接地址、arrival_date、departure_date、currency_code、rooms、facilities_block.facilities、block 和 composite_price_breakdown。房型区块含 block_id、入住人数、价格及取消与预付款政策。未传日期时，文档默认当天至四天后；可复现比价需填写两端日期。不存在的 ID 曾返回 HTTP 200，但 status=false、status_code=400、message=NO DATA!、data=null；这不能说明其他 NO DATA 的统一原因。

使用已知 hotel_id，并沿用所选住宿的 checkin_date、checkout_date、adults、children_age、rooms 与 currency_code。可用 units 和 temperature_unit 调整文档所述的显示单位。该独立房型接口尚未实测，不能假定其结构与已测试的酒店详情相同。设计房型选择器前，应核对实际房型标识、金额、入住人数和条款。查询不会锁房或购买房间。

以数字 hotel_id 查询文档所述的日历，可附起始 checkin_date、rooms、children_age、currency_code 与 language_code。该接口没有 adults 或 checkout_date，不要照搬酒店详情参数。实际响应、日历覆盖范围、每日状态字段和价格覆盖均未实测。返回日期仅可作为后续明确日期的酒店或房型查询候选，不代表房间已保留。

使用 hotel_id 读取酒店介绍，可选 currency_code 和 language_code。该独立介绍接口尚未实测，发布前需检查文本结构、实际语言和缺漏。描述内容与按日期变化的房价不同，其使用仍受适用内容权利约束。

使用 hotel_id 查询文档所述设施，可附 checkin_date、checkout_date、currency_code 与 language_code。省略日期时，文档默认当天至四天后；应明确所选日期以保持住宿条件一致。该独立设施接口尚未实测，不能假定与已测试酒店详情中的 facilities_block 结构相同。

以数字 hotel_id 请求照片信息；此接口没有日期、币种、语言或分页参数。独立照片响应尚未实测，不保证图片链接字段、尺寸、数量或使用许可。制作或缓存酒店图库前，需核对实际图片引用与内容使用权。

使用 hotel_id 查询酒店级政策，可选 currency_code 与 language_code。该响应尚未实测，政策分区、完整性和准确字段需另行检查。本接口没有住宿日期或房型区块参数，通用酒店规则不能代替特定日期房型的取消与预付款条款。

使用 hotel_id 查看文档所述周边信息，可选 language_code 与 currency_code。该接口尚未实测，展示前需核对实际类别、地点引用和距离标签。这是酒店周边资料查询，不是路线规划、实时公交数据或保证准确的步行时间计算。

按 hotel_id 读取文档所述酒店问答，可选 language_code 与 currency_code。此 GET 接口没有问题文本或提交字段，不能发布新问题。响应尚未实测，用于旅客支持知识库前，需核对问答结构、覆盖范围和内容使用权。

以只读方式提供 hotel_id 与一个或多个逗号分隔的 blockIds；区块标识来自酒店详情 data.block[].block_id。沿用原日期、成人数、儿童年龄、房间数和币种。此接口尚未实测，不承诺返回结算字段或确认编号。虽然名称涉及预订流程，这个 GET 请求不会创建、支付或确认酒店订单。

按 hotel_id 使用 page、page_size、sort 查询评论，可按住客类型、评论语言、季节和主题筛选。文档支持逗号分隔筛选值，默认 page=1、page_size=25、sort=sort_most_relevant。应通过配套评论元数据接口发现可用筛选与排序标识。此接口尚未实测，评论字段、总数和分页行为需检查，不能套用酒店搜索的表现。

按数字 hotel_id 获取文档所述评论评分，可选 currency_code 与 language_code。该评分接口尚未实测，比较酒店前需检查评分维度、数值量表、样本数与缺失字段。如研究评分变化，应自行记录采集时间；不能将其描述为原生历史评分数据源。

以 hotel_id 查看文档较少的评论特征接口，可选 language_code 与 currency_code。此接口没有已验证响应或详细特征结构。检查实际字段前，应将结果视为探索性评论元数据；仅凭接口名称不能认定它提供情感分析、主题提取、摘要或特定评分结构。

按 hotel_id 读取文档所述综合评论筛选元数据，可选 language_code 与 currency_code。在读取评论页前，使用同一家酒店的上下文核验住客、语言、季节和主题选项。此响应尚未实测，不能假定它包含每个独立筛选接口的全部内容或采用相同嵌套结构。

按 hotel_id 获取文档所述住客分组元数据，可选 language_code 与 currency_code。将标识传入 get-hotel-review 的 filter_customer_type 前，先检查支持的选项。此独立元数据接口尚未实测，标签、数量和完整性应以实际数据核验；它只读取筛选选项，不返回对应评论页。

按 hotel_id 获取文档所述评论语言元数据，可选 language_code 与 currency_code。将标识传入 get-hotel-review 的 filter_language 前，先检查支持的值。此接口尚未实测，标签、数量和完整性需核对实际数据；它只返回筛选选项，不读取相应评论页。

按 hotel_id 获取文档所述季节分组元数据，可选 language_code 与 currency_code。传入 get-hotel-review 的 filter_time_of_year 前，需检查支持的标识。此接口尚未实测，选项标签、数量和完整性需核对；它读取筛选选项，而非相应评论页。

按 hotel_id 获取文档所述评论主题元数据，可选 language_code 与 currency_code。传入 get-hotel-review 的 filter_topic 前，先核对支持标识。此独立元数据接口尚未实测，标签、数量和完整性需检查实际数据；它读取筛选选项，不返回对应评论页。

按 hotel_id 获取文档所述评论排序元数据，可选 language_code 与 currency_code。文档指向 categories[].id，供 get-hotel-review 的 sort 使用，包括相关性、时间及评分排序。此衔接尚未实测；启用最新评论采集或按评分排序前，需检查实际支持标识。

query 可使用文档支持的数字酒店 ID、酒店房源链接或酒店名称；可附日期、人数、房间数、币种和显示偏好。这些形式仅有文档依据，此灵活查询接口尚未实测，不能默认沿用 get-hotel-details 的已测结构。住宿自动补全不可用，请从独立已知酒店开始，并核对返回身份。

query 可使用已知酒店 ID、房源链接或支持的酒店名称，读取文档所述房型。沿用旅客选择的明确日期、成人数、儿童年龄、房间数和币种。此接口尚未实测，展示前需检查酒店身份、房型结构、计价单位及条款。读取不会预订房间。

query 可使用已知酒店 ID、房源链接或支持的名称查询文档所述房态日历。可选 checkin_date、rooms、children_age、currency_code、language_code；此处没有 adults 与 checkout_date。该接口尚未实测，包括链接与 ID 响应是否一致、日历覆盖期限和价格范围。

query 可用已知酒店 ID、房源链接或受支持名称；可附入住离店日期、币种与语言。文档日期默认当天至四天后，查询所选住宿应明确两端日期。此灵活设施接口尚未实测，展示前需验证解析出的酒店及实际设施字段。

在独立房源列表流程中提供 location 及必填的 checkin_date、checkout_date。可选成人数、children、children_age、房间数、最低卧室数、浴室数、床位数、类别、币种、语言、页码和排序。此流程使用原字段 categories-filter。接口尚未实测，用于亲子住宿前需核对返回位置、房源身份与容量字段的实际含义。

使用已知 dest_id、dest_type 及必填入住离店日期查询房源列表。可选成人数、儿童数与年龄、房间数、最低卧室浴室床位数、categories-filter、币种、语言、页码与排序。住宿自动补全不可用，须独立准备目的地标识对。此响应尚未实测，不能假定与 stays-search 的分页或标识一致。

房源地图查询必填东北与西南角经纬度及入住离店日期。可选 bed_rooms、bath_rooms、成人数、儿童年龄、房间数、币种、语言、价格边界、page、page_size、sort 与 categories-filter。此处使用 bed_rooms/bath_rooms，不是位置列表的 min_bedrooms/min_bathrooms。响应、筛选及页大小是否生效均未实测。

这是文档所述的只读 POST：使用用户提供的住宿搜索结果 url，可附 page、currency_code 和 language_code。url 仍是查询参数，没有请求体字段。共享前移除会话和跟踪值，并核对链接内日期与人数。接口尚未实测，需检查哪些搜索条件及分页值真正保留。

使用已知 dest_id/dest_type 和必填住宿日期读取文档所述房源筛选元数据。成人数、儿童数与年龄、房间数、币种、语言及现有 categories-filter 应与目标搜索一致。文档指向 data.filters.options.genericId 作为筛选值。响应及筛选覆盖尚未实测，构造房源搜索前需检查实际选项。

按 dest_id、dest_type 及必填入住离店日期查看文档所述房源排序元数据。可选人数、房间数、类别、币种、语言、页码与 sort，以保持搜索上下文。此响应尚未实测；只使用实际支持的房源排序标识，未经兼容性验证不能套用酒店目的地或航班排序值。

使用 detail_id 获取文档所述房源信息，可选住宿日期、currency_code、language_code。此标识来自房源流程文档中的 detailId，与数字 hotel_id 不可互换。住宿自动补全不可用，须自行准备已知 detail_id。接口尚未实测，补充房源记录前需检查返回身份、日期与价格字段。

这是文档所述的只读 POST，必填 url 为酒店房源链接查询参数。没有独立日期、人数、语言、币种或请求体字段；需核对 URL 内上下文，避免共享会话和跟踪值。实际响应及带日期或本地化链接的处理尚未验证。返回详情不会创建预订。

使用 detail_id 查询文档所述设施，可选 language_code。此接口没有数字 hotel_id、住宿日期或币种字段。保留房源流程的标识来源，不替换成其他酒店或城市 ID。响应尚未实测，关联房源设施前需检查实际字段与缺漏。

使用 detail_id 读取文档所述照片信息，可选 language_code。没有分页、图片尺寸、日期或币种参数。此独立照片响应尚未实测，使用前需核对图片引用和所属房源；图片展示或缓存许可应与 API 访问权分开审查。

用文字 query 查询城市和机场联想。已验证的 London 响应含 status=true、message=Success，以及带 type、name、code、country、countryName 的 data 数组；机场行另有 city/cityName、parent、distanceToCity 等地理信息。结果包括 CITY LON 和 AIRPORT LHR、LGW、STN，也含其他国家的同名地点。应结合类型和地理信息选择；航班搜索文档要求 AIRPORT 代码。联想成功不证明下游航班或价格查询可用。

按文档以 leavingFrom、goingTo 机场代码和明确 departureDate 搜索单程航班，并统一旅客人数与 cabinClass。可选航司、中转、时长、起降时段、页码和排序。省略日期时，文档默认当天加一天。文档指向 data.flightOffers[].token 供 flights-detail 使用，但此字段衔接没有实测依据；航班搜索和价格也未实测。

以 leavingFrom、goingTo、departureDate、returnDate 及一致舱等和人数查询文档所述往返行程。可分别限制去回程时段，并选择航司、中转、时长、排序与页码。文档默认次日出发、出发五天后返程，建议明确两端日期。文档提供报价 token 到详情的衔接，但往返航班字段和价格尚未实测。

按文档使用逗号分隔的 leavingFrom、goingTo、multiStopDates 列表查询多程行程。每段出发地、目的地与日期须逐项对应，使用明确行程日期，不沿用旧示例。可选人数、舱等、航司、时段、directFlightsOnly、中转、排序和页码。响应与报价可用性尚未实测，使用前需核对实际 flightOffers 及详情 token。

这是文档所述单程最低价变体，可按机场对、departureDate、人数、舱等、航司、中转、时长、时段、页码和排序查询。省略出发日期时，文档默认次日。接口尚未实测，不承诺单一最低金额字段、比较覆盖或报价结构。它用于明确日期的当前搜索研究，不是历来最低价或历史票价服务。

按文档使用 leavingFrom、goingTo、明确 departureDate/returnDate 及一致人数和舱等评估往返最低价变体。可用去回程时段、航司、中转、时长、页码与排序约束。该接口尚未实测，不承诺单一最低价字段、必然省钱或可预订。只能比较航线、日期与旅客条件一致的请求。

按文档使用逐项对应、逗号分隔的 leavingFrom、goingTo、multiStopDates 评估多程最低价变体。候选请求应保持旅客年龄、成人数、舱等及航线约束一致。响应、票价汇总、航段覆盖和最低价字段均未验证。比较多程总价前需检查实际行程和金额含义；不保证历史最低价或预订。

使用所选航班搜索报价的 token，可选 languageCode。文档将 token 定位在普通单程、往返或多程搜索的 data.flightOffers[].token。它是不透明报价上下文，不是账号登录凭据，不要公开或硬编码捕获值。详情响应、token 有效期、价格字段和可订状态尚未实测；此接口不预订或购买机票。

以文字 query 查询租车地点，可选 language_code。文档说明 data.id、data.name、data.coordinates.latitude/longitude 可分别衔接按 ID、名称或坐标的租车搜索，但这些仅是文档字段，响应未实测。选择取还车地点前需确认机场、城市、航站楼和国家。

按文档提供必填取还车经纬度、日期与时间搜索租车。驾驶员年龄文档范围为 30 至 65；可选变速箱、供应商、car_type、空调、语言和排序。文档指向 data.search_key 与 search_results.vehicle_info.v_id，供后续车辆查询，并提到返回筛选标识。租车结果、价格、地点处理及全部详情接口均未实测。

使用租车地点联想的 pickUpId，必填取还车日期和时间。可选 driver_age、transmission、hasAirConditioning、language_code。不要以机场代码、酒店 ID 或猜测值替代 pickUpId。此 ID 搜索响应及其与坐标租车结果的关系尚未实测。

使用 pickUpLocation 和可选 dropOffLocation 名称查询文档所述租车候选。比价应明确取还车日期和时间；文档省略日期默认当天取车、五天后还车。可选驾驶员年龄、供应商、变速箱、空调、语言和排序。地点名应来自已确认的租车地点建议；实际名称解析和租车价格尚未验证。

用必填 search_key 和 vehicle_id 查看文档所述车辆规格及报价上下文，可选 currency_code、language_code、unit。两个必填值须来自同次租车搜索；search_key 是不透明报价上下文，不是登录凭据，示例不提供捕获密钥默认值。此响应及有效期尚未实测，产品使用前需检查实际字段。

按必填 search_key、vehicle_id 查看所选车辆的文档所述套餐，可选 currency_code、language_code、unit。必填值须来自同次搜索；search_key 是不透明报价上下文，不是账号登录信息，示例不提供捕获 key 默认值。此独立响应和有效期尚未实测，使用前需检查字段。

按必填 search_key、vehicle_id 查看选中车辆报价关联的文档所述供应商信息，可选 currency_code、language_code、unit。必填值须来自同次租车搜索；search_key 是不透明报价上下文，不是登录凭据，示例不提供捕获 key 默认值。此响应和有效期尚未实测，使用前需核对字段。

按必填 search_key、vehicle_id 查看选中车辆的文档所述提车地点，可选 currency_code、language_code、unit。必填值须来自同次租车搜索；search_key 是不透明报价上下文，不是登录信息，示例不提供捕获 key 默认值。此独立响应和有效期尚未实测，使用前需核对实际字段。

按必填 search_key、vehicle_id 查看具体租车报价的文档所述供应商评价，可选 currency_code、language_code、unit。两值须来自同次搜索；search_key 是不透明报价上下文，不是登录信息，示例不提供捕获 key 默认值。此独立响应及有效期尚未实测，使用前应检查实际字段。

使用 query 查找景点目的地，可选 currency_code、language_code。文档指出 cityUfi 用于 attraction-search 和 attraction-get-filters 的目的地输入。此联想接口尚未实测，构造游览搜索前需核对城市身份、地理信息和字段结构。景点目的地标识与酒店及航班标识分开处理。

以已知 city_ufi 查询文档所述景点产品，可选 start_date/end_date、币种、语言、page、page_size，以及返回的类别、标签、城市和价格筛选值。文档指向 data.products[].slug/id 供详情和可订查询使用，filterOptions 用于筛选。这些字段未经实际观察；景点搜索和后续可订查询尚未实测，展示前需检查产品、日期与条款。

使用 city_ufi 读取文档所述活动筛选维度；可选起止日期、币种、语言及已选筛选条件应与景点搜索一致。文档指向 filterOptions 中 typeFilters、ufiFilters、labelFilters、priceFilters 的 tagname 值。响应与覆盖尚未验证；目的地或游览日期改变后应刷新，不能假定标识通用。

使用景点搜索返回的产品 slug 查询文档所述详情，可选 currency_code、language_code；显示标题不能代替 slug。此响应尚未实测，展示前需检查介绍、条款、产品身份和价格字段。具体日期可订信息应通过 product_id 专属接口查询，不能从详情文本推断。

使用所选 product_id 和必填 YYYY-MM-DD 日期，可选 currency_code、language_code。文档规定 product_id 来自景点搜索产品 id，不是 slug 或 city_ufi。实际可订响应、时段、价格和容量均未验证。任何返回选项都只是信息性候选，不代表已购票或保留名额。

按所选 product_id 查看文档所述可订日历，可选 currency_code、language_code。此请求没有日期范围或游览日期字段，不应自行添加。响应、日历期限、每日价格和状态含义尚未验证。应先检查候选日期，再单独查询该产品在具体日期的可订信息。

以文字 query 查询接送上下车地点，可选 language_code。文档指出 googlePlaceId 用于 taxi-search 的 pick_up_place_id、drop_off_place_id。此联想响应尚未实测。构造接送请求前应核对机场、酒店、入口和地理背景，不以酒店 ID 或航班机场代码替代地点标识。

按文档提供必填 pick_up_place_id、drop_off_place_id、pick_up_date、pick_up_time 查询接送候选；地点标识来自接送地点发现，可选 language_code、currency_code。响应、车型、报价字段及可用性尚未验证。此只读搜索不预订车辆、不派司机，也不跟踪航班延误。

查看文档所述支持币种，可用 name 过滤。其他支持币种的接口引用返回 code，供 currency_code 或 baseCurrency 使用。此响应尚未实测，制作选择器前需检查实际代码、名称字段和过滤行为。这是支持币种查询，不是汇率或保证换算接口。

查看文档所述语言选项，可用 name 过滤。其他接口使用返回 code，按各自准确拼写传入 language_code 或 languageCode。此响应和过滤未实测。不能假定所有显示语言也是有效的酒店评论语言筛选值，或请求某语言就保证返回翻译内容。

按文档查询参考汇率，可选 baseCurrency，默认 USD。评估旅行费用换算表时应使用支持币种代码并记录获取时间。响应、汇率字段布局、时间戳、币种覆盖和更新频率均未验证。换算估算不等于酒店报价或交易保证汇率。

按文档以 location 和可选 limit 查询地点坐标。酒店搜索文档指向此接口的 centroid.lat、centroid.lon，作为候选搜索坐标。实际地理编码响应、歧义处理与 limit 是否生效尚未验证。将坐标用于酒店半径搜索前需确认地点和地理位置。

调用文档所述无业务参数连通性接口。响应体和成功字段尚未实测，不承诺特定 pong 或数据结构。即使连通性成功，也不能证明酒店价格、评论、目的地查询或其他旅行业务正常；应使用有实际酒店数据的对照请求。