查询已知度假短租的可订数据
查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →用必填的字符串查询参数 rentalId 获取一条已知 Tripadvisor 度假短租记录的可订信息。请从度假短租搜索结果中取得完整的 rentalId 并原样保留。该操作不提供日期、日期区间、入住人数或分页输入,因此无法表达任意指定的入住区间或日历更新。 该操作没有可用的观测探测响应。其未经验证且被截断的源示例展示了一个 data 对象,先按年份、再按月份缩写、再按 YYYY-MM-DD 日期键分组,日期键的值为布尔值。该示例包含历史日期,并未确立当前覆盖范围、日历完整性、true 与 false 的确切含义,或任何额外的信封字段。请把这种嵌套视为示意性的日历形态,而不是有保证的结构。收集快照时请单独记录获取时间,仅从已验证的响应推导日历粒度,不要把返回的标记等同于已确认的库存、价格或预订。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/tripadvisor-data/rental-availability API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/tripadvisor-data/rental-availability?key=<API_KEY>&rentalId=<rentalId>'
查询结果
使用场景
- 在用户选中一条已有的度假短租记录后,为研究工具添加可订检查面板。
- 按 rentalId 存储可订快照并单独记录获取时间,不要把历史示例日期当作当前库存。
- 按示意性的年/月/日期分组原型一个日历解析器,在投入生产前验证其结构与标记含义。
- 说明为什么请求时无法应用任意的入住/离店筛选,因为该查询没有日期查询参数。
- 对比同一条短租记录的连续已验证快照,同时明确区分返回的日期标记与预订确认。
常见问题
rentalId 从哪里获取?
使用度假短租搜索结果中的 rentalId。传入完整的返回字符串,例如文档中的 VacationRentalReview 风格标识,不要用酒店 id 或目的地 geoId 替换。
可以按指定的入住与离店日期查询可订情况吗?
该操作没有声明任何日期参数。它只接受 rentalId,因此无法请求任意的入住窗口。你展示的任何日期都必须来自返回数据,且其覆盖范围已先得到验证。
文档记录了怎样的响应结构?
一份未经验证且不完整的源示例展示了按年份、月份缩写与 YYYY-MM-DD 日期键分组、取值为布尔值的 data。没有成功探测可以确认该结构或完整的响应信封。
true 是否表示该短租一定可以预订?
所提供的证据并未确立这种解读。源示例包含布尔日期标记,但其确切含义、时效性与库存保证均未经验证。请不要把它们呈现为预订确认。
示例日历有多新、有多完整?
该示例包含历史日期且被截断。它并未确立返回的时间跨度、刷新频率或完整性。对任何已验证的快照请自行记录获取时间戳,并避免承诺当前库存。
这个接口可以预订该短租或更新其日历吗?
不可以。这是一个以 rentalId 为输入的 GET 查询,而不是预订或日历写入操作。它不提供预订、定价或日历更新控件。