获取单个酒店的照片与设施内容集合
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →传入必填的酒店 id,以及 YYYY-MM-DD 格式的入住日期 checkIn 和退房日期 checkOut,即可获取该酒店的内容数据。酒店标识需先通过酒店搜索获得,并在作为 id 传入前核对所选结果的标识是否正确。可选的 adults、rooms、childrenAges 和 currency 用来让请求与实际出行人数和住宿安排保持一致。文档中 childrenAges 是年龄数组,取值范围 0 到 17,0 表示不满一岁的儿童。已保存的一次成功 HTTP 200 探测返回了 JSON 对象,包含 status=true、message 字符串、整数 timestamp,以及内含 photos 和 amenitiesScreen 两个数组的 data 对象。探测元数据只能证明这两个集合存在,无法说明其中每个条目的结构或内容是否完整。另有一份被截断的文档示例还显示了带有 title、tags、content 的 data.about,带有 title 和 content 的 amenitiesScreen 分区,以及 data.attractionsNearby.content;这些额外字段未被所提供的探测元数据证实。请显式处理集合为空或字段缺失的情况,不要把内容缺失当作该设施不存在的证据。本接口只是内容查询,不代表预订确认,也不保证房间库存、价格、点评或房源信息完整。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/get-hotel-details API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/get-hotel-details?key=<API_KEY>&checkIn=<checkIn>&checkOut=<checkOut>&id=<id>'
查询结果
使用场景
- 为人工筛选出的酒店候选清单补充照片集合,并在渲染前逐项检查每个照片条目。
- 在已选酒店的页面上增加设施内容面板,同时避免把不完整的集合当成完整的设施清单展示。
- 统计酒店内容覆盖情况,把 photos 或 amenitiesScreen 的有数据、为空和缺失状态与请求失败分开记录。
- 把房源内容附加到已保存的行程选择上,并保留该选择对应的日期、人数、房间数和货币信息。
常见问题
请求酒店内容需要哪些标识和日期?
必填输入是 id、checkIn 和 checkOut,日期格式为 YYYY-MM-DD。文档要求通过酒店搜索获取酒店标识;在把搜索结果的标识作为 id 发送之前,请先核对它是否正确。
酒店详情中实际观测到了哪些字段?
已保存的成功探测返回了 status=true、message 字符串、整数 timestamp,以及包含 photos 和 amenitiesScreen 数组的 data 对象。所提供的探测元数据没有确认这两个数组中各条目的字段。
如何描述儿童和其他出行人员?
可选的 adults 表示 18 岁及以上的成人数量,rooms 表示所需房间数。childrenAges 是 0 到 17 的儿童年龄数组;文档示例 [0,10] 表示一名不满一岁的儿童和一名十岁儿童。文档中没有给出默认的出行人数。
每次返回的详情都能依赖 about 和周边景点字段吗?
不能。一份被截断的文档示例包含 data.about 和 data.attractionsNearby.content,但所提供的探测元数据并未确认这些字段。在检查过实际响应之前,请把它们视为可能出现、尚未验证的示例内容。
设施集合为空是否表示酒店没有这些设施?
不是。内容为空或缺失,只能说明该次请求返回了什么,并不能证明设施不存在;这个内容查询也不会确认房间是否可订或完成预订。