查询已知度假短租的可订数据

查看 Tripadvisor 猫途鹰酒店、民宿与旅行数据 的全部接口 →

用必填的字符串查询参数 rentalId 获取一条已知 Tripadvisor 度假短租记录的可订信息。请从度假短租搜索结果中取得完整的 rentalId 并原样保留。该操作不提供日期、日期区间、入住人数或分页输入,因此无法表达任意指定的入住区间或日历更新。 该操作没有可用的观测探测响应。其未经验证且被截断的源示例展示了一个 data 对象,先按年份、再按月份缩写、再按 YYYY-MM-DD 日期键分组,日期键的值为布尔值。该示例包含历史日期,并未确立当前覆盖范围、日历完整性、true 与 false 的确切含义,或任何额外的信封字段。请把这种嵌套视为示意性的日历形态,而不是有保证的结构。收集快照时请单独记录获取时间,仅从已验证的响应推导日历粒度,不要把返回的标记等同于已确认的库存、价格或预订。

API 功能

已知短租记录查询 使用来自度假短租搜索结果的一个必填 rentalId 字符串;该接口不按目的地或住宿名称搜索。
示意性的年份到日期日历嵌套 未经验证的示例把 data 组织在年份键、月份缩写与 YYYY-MM-DD 日期之下。该分组尚未经探测确认。
布尔日期标记参考 源示例中的日期条目取布尔值,但其可订含义与当前适用性尚未确立。
只读的可订检查 该 GET 操作不接受日历写入字段,也不预订住宿、修改日期或确认预订。
明确的日历查询边界 唯一声明的参数是 rentalId。无法通过该契约请求日期区间、入住人数或页码选择。

在线 API 演示

GET /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。传入完整的返回字符串,例如文档中的 VacationRentalReview 风格标识,不要用酒店 id 或目的地 geoId 替换。

可以按指定的入住与离店日期查询可订情况吗?

该操作没有声明任何日期参数。它只接受 rentalId,因此无法请求任意的入住窗口。你展示的任何日期都必须来自返回数据,且其覆盖范围已先得到验证。

文档记录了怎样的响应结构?

一份未经验证且不完整的源示例展示了按年份、月份缩写与 YYYY-MM-DD 日期键分组、取值为布尔值的 data。没有成功探测可以确认该结构或完整的响应信封。

true 是否表示该短租一定可以预订?

所提供的证据并未确立这种解读。源示例包含布尔日期标记,但其确切含义、时效性与库存保证均未经验证。请不要把它们呈现为预订确认。

示例日历有多新、有多完整?

该示例包含历史日期且被截断。它并未确立返回的时间跨度、刷新频率或完整性。对任何已验证的快照请自行记录获取时间戳,并避免承诺当前库存。

这个接口可以预订该短租或更新其日历吗?

不可以。这是一个以 rentalId 为输入的 GET 查询,而不是预订或日历写入操作。它不提供预订、定价或日历更新控件。

相关接口

相关指南

查看订阅方案 →