内容
快速内容 API 为您提供对 Rapid API 所有属性内容的访问权限。
属性内容 API
以请求的语言返回所请求的在售住宿的住宿编号或完整住宿内容列表。
使用此 API,可根据您的搜索条件检索住宿编号或完整的住宿内容。例如,检索自上周一以来添加的住宿列表,或者检索对应特定住宿编号列表的住宿内容。
内容文件 API
Rapid API 中可用的功能之一是能够导出活动属性及其详细信息的列表。有两种文件 API 可供选择。
住宿目录文件
此 API 返回一个链接,用于下载所请求语言的主要活动属性列表。响应包含有关每家住宿的概要信息。使用此文件可以获取住宿的完整列表。当映射到来自其他供应商的住宿列表时,住宿详细信息则非常有用。
住宿内容文件
此 API 返回一个链接,用于下载所请求语言的所有活动属性的所有内容。响应包括住宿级别、客房级别以及房价级别的信息。使用此文件可以检索所有住宿的全部内容。如果您只需要住宿的子集,则换用住宿内容 API 即可。
非活动属性
有时,之前可以预订的住宿会停业,并在我们的库存中显示为已下线。非活动房产 API 可用于请求自给定完整日期以来处于非活动状态的所有房产的列表,从而允许您更新内容缓存或存储以排除 Rapid API 内不可出售/不可预订的房产。
在下面的示例中,合作伙伴最后一次尝试使用住宿内容 API 或住宿内容文件 API 更新其内容缓存或存储是在 5 月 31 日。这将显示应从系统中删除的带有 property_id
的对象的无序列表。此端点可与住宿内容 API 端点上的以下一个或多个参数结合使用,以增量更新您的内容缓存或存储:date_added_start
、 date_added_end
、date_updated_start
或 date_updated_end
。
示例:
请求:
https://test.ean.com/v3/properties/inactive?since=2023-06-01
响应:
[
{
"property_id": "10003243"
},
{
"property_id": "10012775"
},
{
"property_id": "10013765"
},
{
"property_id": "10017071"
},
{
"property_id": "10041102"
},
{
"property_id": "10042"
},
{
"property_id": "10074774"
},
{
"property_id": "10089905"
},
{
"property_id": "10091055"
},
{
"property_id": "10268276"
},
{
"property_id": "1029882"
},
{
"property_id": "103115"
},
{
"property_id": "10349744"
},
{
"property_id": "10373667"
},
{
"property_id": "1037667"
},
{
"property_id": "1039715"
},
{
"property_id": "10401509"
},
{
"property_id": "104201"
},
{
"property_id": "10465614"
},
{
"property_id": "10484434"
},
{
"property_id": "10488054"
},
{
"property_id": "10520425"
}
]
链参考
此参数返回 Rapid API 识别的链的完整集合。连锁指的是一个有着多个关联品牌的母公司。
一个品牌只可与一个连锁相关联。例如,希尔顿全球酒店集团是一个连锁品牌,旗下拥有多个相关品牌,包括 DoubleTree、Hampton Inn 和 Embassy Suites。
加州度假租赁清洁任务
加州的一项新法律要求度假租赁物业向旅行者披露强制性清洁任务。我们对 API 进行了更改,以便您显示清洁任务。每个使用 Rapid API 的合作伙伴都有责任确保清洁任务的显示方式符合法律规定。
有什么变化?
我们增强了 Rapid API,在checkout
对象中包含一个新说明字段,其中包含度假租赁经理提供的结账说明。
示例:
"checkout": {
"instructions": "<ul> <li>The host requests you complete the following cleaning tasks before checking out:</li><li>Start the dishwasher</li><li>Strip any used beds and gather used towels</li><li>Remove personal items</li><li>Turn off the lights</li> </ul>"
}
其他参考信息
本地化
language
参数仅使用带连字符的 two-digit 语言和国家代码对,在集成任何代码之前请检查支持的语言。
星级
Rapid 内容 API 返回的星级为旅客提供了相应信息,可以帮助旅客大致了解住宿在家具、服务和服务设施方面的情况。详细了解星级评定的运作方式。
参考列表
Rapid 内容 API 提供的住宿信息通常用各种 ID 表示。您可查看参考列表,了解这些 ID 的含义。参考列表仅提供英文版本,但 API 中返回的是经过本地化的名称。
注册编号
Rapid 内容 API 中的 registry_number
参数将返回单个或多个注册详细信息。这些详细信息可能包含单词、字母、数字和特殊字符,具体取决于各个国家/地区的要求。我们提供这些编号,旨在协助您遵守法律法规的展示要求。
示例:
"registry_number": "Property Registration Number 004071AAA-00004, IT005748GHFMUHG",
"registry_number": "IT00574-8GHFMUHG",
库存机会
库存机会页面将为您提供与您与 Rapid API 集成相关的未映射属性列表。我们的住宿供应时常会有变化,您需要定期查看以添加住宿或将其映射到其他提供商的住宿,这样您的旅客就不会遇到重复的住宿或是错过您网站上的新住宿。
API 详情
查看此页面上与内容相关的端点定义,然后使用 API Explorer 或其他测试软件来了解示例和模式定义与实际输出的比较。
其他资源
无论您是想尝试所有 Rapid API 端点还是下载其 OpenAPI 规范或我们的 Postman 集合,我们都能满足您的需求。